终端原生开源 AI 代码 Agent，支持多模型轮转、自定义 Agent、MCP 工具集成与持久化执行，定位为 Cursor/Windsurf 的替代方案。
Code Puppy 是一个运行在终端的 AI 代码生成 Agent，由 Michael Pfaffenberger 开发并维护，采用 MIT 许可证发布。项目旨在作为 Windsurf、Cursor 等付费 AI IDE 的开源替代方案，提供终端原生的 AI 编码体验。
核心能力方面，Code Puppy 开箱支持 OpenAI、Anthropic、Google Gemini、Cerebras、Ollama 等主流模型提供商，并通过 models.dev API 可浏览并一键添加 65+ 提供商的 1000+ 模型。其 Round Robin 模型轮转机制支持多 API Key 负载均衡，自动突破速率限制，实现成本优化。
Agent 系统支持内置 Python Agent（基于 BaseAgent 子类）和用户自定义 JSON Agent，可通过引导式创建工具定义系统提示、工具集和人格。工具集涵盖文件读写（list_files、read_file、create_file、replace_in_file、delete_file）、代码搜索（grep，后端为 ripgrep）、Shell 命令执行等。通过 MCP 协议可集成外部工具服务器。
规范管理通过 AGENTS.md 规则系统实现，支持全局和项目级多级合并加载。自定义 Slash 命令兼容 .claude/commands/、.github/prompts/、.agents/commands/ 三种目录格式。可选的 DBOS 持久化执行插件使 Agent 运行状态自动 checkpoint，支持崩溃恢复和长任务续跑，适用于 CI/CD 场景。
项目基于 pydantic-ai-slim 构建，使用 typer 实现 CLI，rich 渲染终端界面，prompt-toolkit 处理交互输入。构建系统为 Hatchling，代码质量由 Ruff linter 和 Lefthook Git hooks 保障。要求 Python 3.11+，支持 macOS、Linux、Windows 跨平台运行。当前版本 0.0.491，处于快速迭代阶段。