Authorization notice. Code Agent is dual-use. Only use it on software, sites and systems you own or have explicit permission to test.
Who it is forA developer working on a risky or unfamiliar part of a codebase who wants to see the agent's intended steps first.
The problemAn agent that starts editing right away can change many files before you understand what it is doing.
The outcomeYou read a proposed plan, approve or adjust it, and only then let the agent make changes.
What you need first
- Python 3.11 or newer
- uv, the Python package manager
- An API key for a supported model provider, such as DeepSeek, OpenAI, Anthropic, OpenRouter, or ZhipuAI
- A local Git repository or project folder to point the agent at
Steps
- Run
uv run python main.pyin the project folder. - Run
/planto enter plan mode. - Describe the change you want and read the plan the agent proposes.
- Approve the plan or ask for changes, then let the agent carry it out.
Prompt for your agent
In the Harvil1/codeAgent repo, start with `uv run python main.py`, run `/plan`, and ask for <describe the change> in <target project path>. Expect a written plan with steps and no file edits yet. Verify that no files in the target project changed before you approve the plan.
Caveat. The README describes plan mode as presenting a plan for approval before action but does not describe how the plan is stored or edited afterward.
Use this in your AI agent
Ask your agent
Using the Deduped MCP, get the setup steps for Harvil1/codeAgent and "Review an agent's plan before it touches files"
Add Deduped to Claude Code once
claude mcp add --transport http deduped https://dedupedai.com/mcp
Every Monday: the 5 hottest repos and exactly how to use them. Free, one email a week, unsubscribe anytime.
Get them freeShare: X LinkedIn Hacker News Email Copy link
Third-party repos we don't own. AI-written use cases can be wrong. Disclaimer