DEDUPED Hot AI repos, turned into use cases Get the Monday 5
1,026 stars · Python

How to use Code Agent: what you can do with it

What is Code Agent? CodeAgent is an open-source Python command-line coding assistant that reads your code, edits files, runs commands and tests, and works through multi-step tasks in your terminal.

How do I use it? Install uv using the command for your system from the Quick Start section of the README; then run git clone https://github.com/Harvil1/codeAgent.git and then cd codeAgent; run uv sync to install the dependencies. Full steps below.

Trended earlier

View repo on GitHub

Third-party repos we don't own. AI-written use cases can be wrong. Disclaimer

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

  • Hand a multi-step coding task to a terminal agent

    Install CodeAgent, start it in a project, and let it plan, edit files, and run commands until the task is done.

    View prompt
    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.

  • Run the regression suite on agent-made changes

    Use the repo's verify script and ruff lint to check code the agent changed before you commit it.

    View prompt
    In the Harvil1/codeAgent repo, run `uv run python scripts/verify.py` after the changes in <branch or path> are applied. Expect a pass or fail count from the regression checks. Verify that the count shows no failing checks before you report the change as ready.

  • Roll back an agent session to an earlier checkpoint

    Resume the last session and rewind to an earlier checkpoint when the agent's changes went the wrong way.

    View prompt
    In the Harvil1/codeAgent repo, run `uv run python main.py -c` to resume the last session, then run `/rewind` to return to <checkpoint name or position>. Expect the session to show the chosen checkpoint as the current point. Verify by asking the agent to restate the last step it will take before it runs anything.

  • Review an agent's plan before it touches files

    Switch to plan mode so the agent proposes steps and waits for your approval before editing anything.

    View prompt
    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.

Quick start with Code Agent

  1. Check you have what it needs: 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.
  2. Open Harvil1/codeAgent on GitHub and read the README and license.
  3. Install uv using the command for your system from the Quick Start section of the README.
  4. Run git clone https://github.com/Harvil1/codeAgent.git and then cd codeAgent.
  5. Run uv sync to install the dependencies.
  6. Set one provider key, for example DEEPSEEK_API_KEY, as an environment variable, or write it under models. .api_key in ~/.codeAgent/settings.json.

These steps come from our top use case, Hand a multi-step coding task to a terminal agent, which also has a copy-paste agent prompt.

Use this in your AI agent

Ask your agent

Using the Deduped MCP, get the setup steps for Harvil1/codeAgent

Add Deduped to Claude Code once

claude mcp add --transport http deduped https://dedupedai.com/mcp

Cursor, ChatGPT, others

Code Agent alternatives · Best AI repos for Software and DevOps

About this repo

  • Who it is forDevelopers who want a terminal coding agent they can read, change, and run on their own machine, especially on Windows.
  • Why it is hot1k stars, launched 24 days ago, picked up by one AI source we track
  • LanguagePython
  • Sourcegithub.com/Harvil1/codeAgent · Back to Hot repos

Requirements

  • 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

Add this badge to your README

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

Markdown 

[![Use cases on Deduped](https://dedupedai.com/badge/Harvil1/codeAgent.svg)](https://dedupedai.com/use-cases/harvil1-codeagent/?utm_source=github&utm_medium=badge&utm_campaign=Harvil1-codeAgent)

HTML 

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

A static image, no tracking script. About the badge

Questions about Code Agent

What is Code Agent?

CodeAgent is an open-source Python command-line coding assistant that reads your code, edits files, runs commands and tests, and works through multi-step tasks in your terminal. It is an open-source project on GitHub: https://github.com/Harvil1/codeAgent.

How do I use Code Agent?

Install uv using the command for your system from the Quick Start section of the README; then run git clone https://github.com/Harvil1/codeAgent.git and then cd codeAgent; run uv sync to install the dependencies. The use cases on this page give the full steps and a copy-paste agent prompt for each job.

Who is Code Agent for?

Developers who want a terminal coding agent they can read, change, and run on their own machine, especially on Windows.

What can I do with Code Agent?

4 use cases so far, for example: Hand a multi-step coding task to a terminal agent; Run the regression suite on agent-made changes; Roll back an agent session to an earlier checkpoint. Each has steps and a copy-paste agent prompt.

What do I need to run Code Agent?

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.

What are alternatives to Code Agent?

Other hot AI repos in Software and DevOps: Deep Infer, Harness2, Orca, Opencode, Graphify.

Is Code Agent 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.