Authorization notice. Code Agent is dual-use. Only use it on software, sites and systems you own or have explicit permission to test.
Credentials. The API key can be stored as an environment variable or in ~/.codeAgent/settings.json, so keep that file out of shared repos and backups.
Credentials. Approve shell commands and file writes only after reading them, since the agent can run terminal commands in the project.
Who it is forA developer with an existing project who has a multi-file change to make and wants an agent to do the routine edits in the terminal.
The problemRoutine multi-file changes take time to plan and type out, and a chat window cannot read or run anything in the repo.
The outcomeThe agent works inside the project folder, reads the code, changes files, runs commands and tests, and reports when the task is finished.
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
- Install uv using the command for your system from the Quick Start section of the README.
- Run
git clone https://github.com/Harvil1/codeAgent.gitand thencd codeAgent. - Run
uv syncto install the dependencies. - Set one provider key, for example
DEEPSEEK_API_KEY, as an environment variable, or write it undermodels. .api_keyin~/.codeAgent/settings.json. - Run
uv run python main.pyand describe the change you want in plain language.
Prompt for your agent
Using the Harvil1/codeAgent repo, start the interactive mode with `uv run python main.py` and give it the task: <describe the change for the target project at <path>>. Expect the agent to read the relevant files, edit them, and report a final summary. Verify by checking that the files named in the summary changed in the target project.
Caveat. The README and in-code comments are written in Chinese, and macOS is described as theoretically usable but not fully verified.
Use this in your AI agent
Ask your agent
Using the Deduped MCP, get the setup steps for Harvil1/codeAgent and "Hand a multi-step coding task to a terminal agent"
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