Coding agent (CLI) · Michael Pfaffenberger (mpfaffenberger)
Code Puppy review
Quick verdict. Code Puppy: Open-source Python coding agent for the terminal, built on Pydantic AI, with sub-agents, MCP servers, custom slash commands and AGENTS.md rules. Suits Python-minded developers who want a hackable terminal coding agent with MCP support and a free choice of model provider. A weaker fit for anyone who wants a graphical workspace or a zero-dependency compiled binary.
Code Puppy review
Code Puppy is an open-source coding agent for the terminal, written in Python on top of Pydantic AI. It aims at the same job as Aider, Claude Code and opencode: you describe a coding task and it reads, edits and runs code in your project. This review follows the project site, the GitHub README and repository and the PyPI page, read on 18 November 2026, and we did not run an independent test.
What it does
The README describes a main agent plus sub-agents that share the same tools, including MCP servers and plugin tools. An optional mode gives every agent a single sandboxed Python REPL tool in which the other tools are functions it can call. Project rules load from AGENTS.md files, global or per project, and custom slash commands can be written as markdown files in .claude/commands/, .github/prompts/ or .agents/commands/. An optional durable-execution plugin checkpoints agent runs so a long run can resume after a crash. You bring your own model keys, or point it at an Ollama endpoint.
Price and licence
It is free and open source under the MIT licence, with no plan to buy; you pay your model provider. It installs with pip, uvx or pipx and needs Python 3.11 or newer; the README has a Windows section as well as macOS and Linux. The repository showed 882 stars on 18 November 2026 and its last push was on 16 November 2026.
Limits
It needs a Python install rather than a single binary, and it is a terminal tool with no graphical window, diff canvas or browser preview. It is largely one maintainer's project: the contributor list shows mpfaffenberger with 1,681 contributions and the next human far behind. There is no hosted plan or bundled model. We have not measured speed or answer quality against other agents. If you prefer a compiled single binary, see fx; for a smaller codebase to learn from, see CoreCoder.
Facts: platforms, price and licence
- platforms
- macOSLinuxWindowsPython 3.11+ package installed with pip, uvx or pipx on Linux, macOS and Windows; the README has a Windows section.
- price
- FreeFree and open source (MIT). You bring your own model keys or an Ollama endpoint (README).
- source
- Open sourceLicence: MIT
- github
- mpfaffenberger/code_puppy 885 stars, seen 2026-11-22
Code Puppy features
- ✓ yes MCP
Not verified: Multi-agent, Headless / CI, Sandbox, Local models, Your own API key, Git worktrees, SSH. How to read feature data.
Code Puppy strengths
- Built on Pydantic AI, with main agents and sub-agents that share the same tools
- MCP servers and plugin tools are available to every agent; an optional mode gives agents a single sandboxed Python REPL tool that calls the others
- Project rules load from `AGENTS.md`, and custom slash commands can be written as markdown files in `.claude/commands/`, `.github/prompts/` or `.agents/commands/`
- Optional durable-execution plugin checkpoints agent runs so they can resume after a crash
- MIT licence and active: pushed the day before this check
Code Puppy weak points
- Needs Python 3.11 or newer and a package install; it is not a single binary
- A terminal tool only: no graphical window, diff canvas or browser preview
- Mostly one maintainer: the contributor list shows mpfaffenberger with 1,681 contributions, next human far behind
- You supply the model access; there is no bundled model or hosted plan
Who Code Puppy is for
- best for
- Python-minded developers who want a hackable terminal coding agent with MCP support and a free choice of model provider.
- look elsewhere if
- Anyone who wants a graphical workspace or a zero-dependency compiled binary.
Lists that include Code Puppy
Similar tools
Sources
Checked 2026-10-21. Prices and features change; the vendor's page is the authority.
- code-puppy.dev — official site
- github.com/mpfaffenberger/code_puppy — README: install, Python 3.11+, Pydantic AI, MCP, AGENTS.md, commands; licence, stars and contributors from the GitHub API
- pypi.org/project/code-puppy — package distribution
Not verified: Hands-on behaviour not tested; git_worktrees, multi_agent: not confirmed in the README sections read (null, not false)