DEDUPED Hot AI repos, turned into use cases Get the Monday 5

What you can do with Agent 2

Agent-2 is a Python agent harness that runs on your machine with your own Gemini API keys and can write code, run terminal commands, manage files, and coordinate tools.

Trended earlier

aaravshah1311/Agent-2 on GitHub

Third-party repos we don't own or vouch for. AI-generated use cases can be wrong: review everything and run at your own risk.

Authorization notice. This tool is dual-use. Only use it on software, sites and systems you own or have explicit permission to test, and follow the relevant licenses and terms of service.

What do you want to do?

4 use cases

  • Document an unfamiliar codebase in one pass

    Generate a project doc that every later agent prompt reads back as fact.

    View prompt
    Use the Agent-2 repo at <path-to-agent2> to run /init on the project at <path-to-project>. Expected output: a generated .agent2/agent2.md inside the project. Verify that the file names the real entry points and build steps of the project.

  • Fix a bug with a diff review before each write

    Have the agent debug code while you see every change computed before it is written.

    View prompt
    Use the Agent-2 repo at <path-to-agent2> in CLI mode to fix the failing test in <path-to-project>. Expected output: the minimal code change and a list of files edited. Verify by rerunning the failing test command yourself and confirming it passes.

  • Drive Burp or ZAP scans from the agent

    Let the agent work through Burp Suite or OWASP ZAP on a target you are allowed to test.

    View prompt
    Use the Agent-2 repo at <path-to-agent2> with the Burp Suite MCP bridge to review <authorized-target-url> for issues. Expected output: a list of findings with severity and the request that produced each one. Verify that every finding is reproducible in Burp before you report it.

  • Run the agent in a browser with live tool calls

    Watch streaming tool calls and multi-tab terminals in a web UI on localhost.

    View prompt
    Start the Agent-2 web server from <path-to-agent2> with `python run.py --web` and use it to add a unit test to <path-to-project>. Expected output: the new test file and a streamed log of tool calls. Verify that the test runs and passes when you run it yourself.

How to use Agent 2

  1. Check you have what it needs: Python 3.9 or newer; A free Gemini API key from aistudio.google.com/apikey; A local project folder you want the agent to work in.
  2. Open aaravshah1311/Agent-2 on GitHub and read the README and license.
  3. Run git clone https://github.com/aaravshah1311/Agent-2.git and then cd Agent-2.
  4. Run python run.py to create the virtual environment, install dependencies, and enter your Gemini API key.
  5. Run python run.py --cli and point the agent at the project you want documented.
  6. Type /init so the agent walks the project and writes .agent2/agent2.md.

These steps come from our top use case, Document an unfamiliar codebase in one pass, which also has a copy-paste agent prompt.

Agent 2 alternatives · Best AI repos for Software and DevOps

About this repo

Requirements

  • Python 3.9 or newer
  • A free Gemini API key from aistudio.google.com/apikey
  • A local project folder you want the agent to work in
  • For the security use case: Burp Suite or OWASP ZAP installed, and written permission to test the target

Add this badge to your README

Maintain Agent 2? Show readers where to find these use cases. Use cases on Deduped

Markdown 

[![Use cases on Deduped](https://dedupedai.com/badge/aaravshah1311/Agent-2.svg)](https://dedupedai.com/use-cases/aaravshah1311-agent-2/?utm_source=github&utm_medium=badge&utm_campaign=aaravshah1311-Agent-2)

HTML 

<a href="https://dedupedai.com/use-cases/aaravshah1311-agent-2/?utm_source=github&amp;utm_medium=badge&amp;utm_campaign=aaravshah1311-Agent-2"><img src="https://dedupedai.com/badge/aaravshah1311/Agent-2.svg" alt="Use cases on Deduped" height="20"></a>

A static image, no tracking script. About the badge

Questions about Agent 2

What is Agent 2?

Agent-2 is a Python agent harness that runs on your machine with your own Gemini API keys and can write code, run terminal commands, manage files, and coordinate tools. It is an open-source project on GitHub: https://github.com/aaravshah1311/Agent-2.

Who is Agent 2 for?

Developers and technical operators who want an autonomous coding and terminal agent that keeps all its state in a local SQLite file.

What can I do with Agent 2?

4 use cases so far, for example: Document an unfamiliar codebase in one pass; Fix a bug with a diff review before each write; Drive Burp or ZAP scans from the agent. Each has steps and a copy-paste agent prompt.

What do I need to run Agent 2?

Python 3.9 or newer; A free Gemini API key from aistudio.google.com/apikey; A local project folder you want the agent to work in; For the security use case: Burp Suite or OWASP ZAP installed, and written permission to test the target.

What are alternatives to Agent 2?

Other hot AI repos in Software and DevOps: Omarchy Local AI, Hermes Plan Mode, Agnes Harness, Skills, Awesome Jev.

Is Agent 2 safe to run?

Deduped does not own, audit or vouch for it. Read the README and license, run it on your own systems first and review every command before you run it.