repopilot-agent 0.1.0__tar.gz

repopilot_agent-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ZhangYang2297
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

repopilot_agent-0.1.0/PKG-INFO

@@ -0,0 +1,272 @@
+Metadata-Version: 2.4
+Name: repopilot-agent
+Version: 0.1.0
+Summary: Local-first AI code agent in your terminal. Inspired by Claude Code and Codex CLI.
+Author: ZhangYang2297
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/ZhangYang2297/repopilot
+Project-URL: Repository, https://github.com/ZhangYang2297/repopilot
+Project-URL: Issues, https://github.com/ZhangYang2297/repopilot/issues
+Keywords: ai,code-agent,cli,coding-assistant,llm,developer-tools
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Code Generators
+Classifier: Topic :: Software Development :: Quality Assurance
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: typer>=0.12
+Requires-Dist: rich>=13
+Requires-Dist: prompt-toolkit>=3.0
+Requires-Dist: litellm>=1.40
+Requires-Dist: openai>=1.30
+Requires-Dist: docker>=7.0
+Requires-Dist: tree-sitter<0.22,>=0.21
+Requires-Dist: tree-sitter-python<0.22,>=0.21
+Requires-Dist: pathspec>=0.12
+Requires-Dist: structlog>=24.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: jinja2>=3.1
+Requires-Dist: httpx>=0.27
+Requires-Dist: diskcache>=5.6
+Requires-Dist: tomli>=2.0; python_version < "3.11"
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: pytest-timeout; extra == "dev"
+Requires-Dist: pytest-cov; extra == "dev"
+Requires-Dist: ruff>=0.5; extra == "dev"
+Requires-Dist: ipython; extra == "dev"
+Dynamic: license-file
+
+<div align="center">
+
+# RepoPilot
+
+**Local-first AI code agent in your terminal.**
+
+[English](README.md) | [中文](README.zh-CN.md)
+
+[![Python](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org)
+[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+[![PyPI version](https://img.shields.io/pypi/v/repopilot-agent.svg)](https://pypi.org/project/repopilot-agent/)
+
+</div>
+
+## What is RepoPilot?
+
+RepoPilot is a CLI coding agent inspired by Claude Code and Codex CLI. Navigate to any project, run `repopilot`, and describe what you want done in natural language — RepoPilot reads, searches, edits, runs tests, and fixes bugs autonomously in a sandboxed environment.
+
+```
+$ cd your-project
+$ repopilot
+
+────────────────────────────── RepoPilot ──────────────────────────────
+  Directory: /your-project
+  Model:     doubao-seed-evolving
+  Sandbox:   local
+  Approval:  auto
+
+Type /help for commands, /exit to quit.
+
+repopilot> fix the failing test in test_auth.py
+> read_file(path=test_auth.py)
+> bash(command=python -m pytest test_auth.py -v)
+> edit_file(path=auth.py, ...)
+> bash(command=python -m pytest test_auth.py -v)
+
+  All tests pass. Fixed the token validation bug in auth.py line 42.
+```
+
+## Features
+
+- **Claude Code / Codex CLI style REPL** — `cd project && repopilot`, start chatting immediately
+- **Pure ReAct agent loop** — single model does all thinking, no multi-agent overhead
+- **Persistent multi-turn conversation** with automatic context compaction
+- **Layered memory system** — global + project `REPOPILOT.md` files (like CLAUDE.md)
+- **Cross-session resume** — `/resume` to continue where you left off
+- **Docker sandbox** with CPU/memory limits and optional network isolation
+- **4 approval modes**: auto / confirm / edit-only / deny
+- **Dangerous command blacklist** (path traversal, `rm -rf /`, `curl|sh`, force push, credential theft)
+- **10 built-in tools**: read/write/edit/grep/glob/list_dir/bash/run_python/repo_tree/finish
+- **tree-sitter repo map** — code structure overview without reading every file
+- **Circuit breaker + exponential backoff** for reliable LLM calls
+- **Cross-platform** — Windows / Linux / macOS with automatic Unix→Windows command translation
+- **Any OpenAI-compatible LLM** — use your own API key (Doubao, DeepSeek, OpenAI, vLLM, local models, etc.)
+- **No RAG / no vector database** — deterministic grep/glob/tree-sitter retrieval is faster and more accurate for code
+
+## Installation
+
+```bash
+pip install repopilot-agent
+```
+
+Or install the latest version directly from GitHub:
+
+```bash
+pip install git+https://github.com/ZhangYang2297/repopilot.git
+```
+
+For an isolated install (recommended for CLI tools):
+
+```bash
+pipx install repopilot-agent
+```
+
+**Requirements**: Python 3.10+
+
+### First Run
+
+On first run you will be prompted for your LLM configuration:
+
+1. **Model name** (e.g. `openai/doubao-seed-evolving`, `openai/gpt-4o`, `openai/deepseek-chat`)
+2. **API key** (sk-...)
+3. **Base URL** (for providers other than OpenAI, e.g. `https://ark.cn-beijing.volces.com/api/v3`)
+
+You can also configure via environment variables:
+
+```bash
+export REPOPILOT_MODEL=openai/doubao-seed-evolving
+export REPOPILOT_API_KEY=sk-your-key
+export REPOPILOT_BASE_URL=https://ark.cn-beijing.volces.com/api/v3
+```
+
+## Usage
+
+### Interactive Mode (Recommended)
+
+```bash
+cd your-project
+repopilot                          # current directory, local sandbox, auto approval
+repopilot -r ../other-proj         # specify a different project directory
+repopilot --sandbox docker         # run inside a Docker container
+repopilot --approval-mode confirm  # confirm before writes/executions
+repopilot -m openai/gpt-4o         # override model
+```
+
+### One-shot Task Mode
+
+```bash
+repopilot chat "fix the bug in auth.py"
+repopilot chat "add --verbose flag to cli.py" -r ./myproj
+```
+
+### Slash Commands
+
+| Command | Description |
+|---------|-------------|
+| `/exit`, `/quit` | Exit (Ctrl+C / Ctrl+D also supported) |
+| `/help` | Show help |
+| `/model [name]` | Show or switch model |
+| `/approval [mode]` | Switch approval mode |
+| `/compact` | Trigger context compaction |
+| `/clear` | Start fresh conversation |
+| `/cd [path]` | Switch working directory |
+| `/memory [note]` | Show or add memory notes |
+| `/resume [id]` | Resume a previous session |
+| `/sessions` | List recent sessions |
+| `/cost` | Show token usage/cost |
+| `/status` | Show current configuration |
+
+### Project Memory (REPOPILOT.md)
+
+Create a `REPOPILOT.md` in your project root to give RepoPilot persistent instructions:
+
+```markdown
+# Project Memory
+
+## Build/Test
+- Test: python -m pytest tests/ -v
+- Lint: ruff check .
+
+## Conventions
+- Use type hints on all functions
+- Never modify files in migrations/
+```
+
+Global memory lives at `~/.repopilot/REPOPILOT.md` and applies across all projects.
+
+## Configuration
+
+Config file: `~/.repopilot/config.toml`
+
+```toml
+[core]
+model = "openai/doubao-seed-evolving"
+api_key = "sk-..."
+base_url = "https://ark.cn-beijing.volces.com/api/v3"
+sandbox_type = "local"
+approval_mode = "auto"
+max_steps = 200
+budget_tokens = 500000
+tool_timeout = 120
+```
+
+Manage config via CLI:
+
+```bash
+repopilot config show
+repopilot config set model openai/gpt-4o
+repopilot config init  # re-run setup wizard
+repopilot models       # list recommended models
+```
+
+## Architecture
+
+```
+┌─────────────────────────────────┐
+│  CLI (Typer + Rich)    REPL     │
+├─────────────────────────────────┤
+│  Agent Loop (ReAct)             │
+├─────────────────────────────────┤
+│  Context Manager  L0-L5 memory  │
+├─────────────────────────────────┤
+│  Tool Registry + Permission     │
+├─────────────────────────────────┤
+│  Sandbox (Local / Docker)       │
+├─────────────────────────────────┤
+│  LLM Service (LiteLLM)          │
+└─────────────────────────────────┘
+```
+
+## Built-in Tools
+
+| Tool | Description |
+|------|-------------|
+| `read_file` | Read a file (with optional line range and offset limit) |
+| `write_file` | Write content to a file (creates or overwrites) |
+| `edit_file` | Find-and-replace edit (string replacement) |
+| `grep_search` | Search file contents with regex |
+| `glob` | Find files by glob pattern |
+| `list_dir` | List directory contents |
+| `repo_tree` | Show tree-sitter generated repository map |
+| `bash` | Execute a shell command (sandboxed) |
+| `run_python` | Execute Python code in an isolated temp file |
+| `finish` | Signal task completion and return to user |
+
+## Supported LLM Providers
+
+Any OpenAI-compatible endpoint works out of the box via [LiteLLM](https://docs.litellm.ai/):
+
+- **Volcengine ARK (Doubao)** — recommended, tested extensively
+- **OpenAI** (GPT-4o, GPT-4, o1, etc.)
+- **DeepSeek** (deepseek-chat, deepseek-reasoner)
+- **Alibaba Qwen** (qwen2.5-coder series)
+- **Zhipu GLM** (glm-4, glm-5 series)
+- **Local models** via vLLM / Ollama / llama.cpp (any OpenAI-compatible server)
+- **Anthropic Claude** (via LiteLLM)
+
+## License
+
+MIT — see [LICENSE](LICENSE) for details.
+
+## Acknowledgements
+
+Built after studying Claude Code (Anthropic), Codex CLI (OpenAI), and the SWE-bench / SWE-agent research.
+
+

repopilot_agent-0.1.0/README.md

@@ -0,0 +1,226 @@
+<div align="center">
+
+# RepoPilot
+
+**Local-first AI code agent in your terminal.**
+
+[English](README.md) | [中文](README.zh-CN.md)
+
+[![Python](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org)
+[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+[![PyPI version](https://img.shields.io/pypi/v/repopilot-agent.svg)](https://pypi.org/project/repopilot-agent/)
+
+</div>
+
+## What is RepoPilot?
+
+RepoPilot is a CLI coding agent inspired by Claude Code and Codex CLI. Navigate to any project, run `repopilot`, and describe what you want done in natural language — RepoPilot reads, searches, edits, runs tests, and fixes bugs autonomously in a sandboxed environment.
+
+```
+$ cd your-project
+$ repopilot
+
+────────────────────────────── RepoPilot ──────────────────────────────
+  Directory: /your-project
+  Model:     doubao-seed-evolving
+  Sandbox:   local
+  Approval:  auto
+
+Type /help for commands, /exit to quit.
+
+repopilot> fix the failing test in test_auth.py
+> read_file(path=test_auth.py)
+> bash(command=python -m pytest test_auth.py -v)
+> edit_file(path=auth.py, ...)
+> bash(command=python -m pytest test_auth.py -v)
+
+  All tests pass. Fixed the token validation bug in auth.py line 42.
+```
+
+## Features
+
+- **Claude Code / Codex CLI style REPL** — `cd project && repopilot`, start chatting immediately
+- **Pure ReAct agent loop** — single model does all thinking, no multi-agent overhead
+- **Persistent multi-turn conversation** with automatic context compaction
+- **Layered memory system** — global + project `REPOPILOT.md` files (like CLAUDE.md)
+- **Cross-session resume** — `/resume` to continue where you left off
+- **Docker sandbox** with CPU/memory limits and optional network isolation
+- **4 approval modes**: auto / confirm / edit-only / deny
+- **Dangerous command blacklist** (path traversal, `rm -rf /`, `curl|sh`, force push, credential theft)
+- **10 built-in tools**: read/write/edit/grep/glob/list_dir/bash/run_python/repo_tree/finish
+- **tree-sitter repo map** — code structure overview without reading every file
+- **Circuit breaker + exponential backoff** for reliable LLM calls
+- **Cross-platform** — Windows / Linux / macOS with automatic Unix→Windows command translation
+- **Any OpenAI-compatible LLM** — use your own API key (Doubao, DeepSeek, OpenAI, vLLM, local models, etc.)
+- **No RAG / no vector database** — deterministic grep/glob/tree-sitter retrieval is faster and more accurate for code
+
+## Installation
+
+```bash
+pip install repopilot-agent
+```
+
+Or install the latest version directly from GitHub:
+
+```bash
+pip install git+https://github.com/ZhangYang2297/repopilot.git
+```
+
+For an isolated install (recommended for CLI tools):
+
+```bash
+pipx install repopilot-agent
+```
+
+**Requirements**: Python 3.10+
+
+### First Run
+
+On first run you will be prompted for your LLM configuration:
+
+1. **Model name** (e.g. `openai/doubao-seed-evolving`, `openai/gpt-4o`, `openai/deepseek-chat`)
+2. **API key** (sk-...)
+3. **Base URL** (for providers other than OpenAI, e.g. `https://ark.cn-beijing.volces.com/api/v3`)
+
+You can also configure via environment variables:
+
+```bash
+export REPOPILOT_MODEL=openai/doubao-seed-evolving
+export REPOPILOT_API_KEY=sk-your-key
+export REPOPILOT_BASE_URL=https://ark.cn-beijing.volces.com/api/v3
+```
+
+## Usage
+
+### Interactive Mode (Recommended)
+
+```bash
+cd your-project
+repopilot                          # current directory, local sandbox, auto approval
+repopilot -r ../other-proj         # specify a different project directory
+repopilot --sandbox docker         # run inside a Docker container
+repopilot --approval-mode confirm  # confirm before writes/executions
+repopilot -m openai/gpt-4o         # override model
+```
+
+### One-shot Task Mode
+
+```bash
+repopilot chat "fix the bug in auth.py"
+repopilot chat "add --verbose flag to cli.py" -r ./myproj
+```
+
+### Slash Commands
+
+| Command | Description |
+|---------|-------------|
+| `/exit`, `/quit` | Exit (Ctrl+C / Ctrl+D also supported) |
+| `/help` | Show help |
+| `/model [name]` | Show or switch model |
+| `/approval [mode]` | Switch approval mode |
+| `/compact` | Trigger context compaction |
+| `/clear` | Start fresh conversation |
+| `/cd [path]` | Switch working directory |
+| `/memory [note]` | Show or add memory notes |
+| `/resume [id]` | Resume a previous session |
+| `/sessions` | List recent sessions |
+| `/cost` | Show token usage/cost |
+| `/status` | Show current configuration |
+
+### Project Memory (REPOPILOT.md)
+
+Create a `REPOPILOT.md` in your project root to give RepoPilot persistent instructions:
+
+```markdown
+# Project Memory
+
+## Build/Test
+- Test: python -m pytest tests/ -v
+- Lint: ruff check .
+
+## Conventions
+- Use type hints on all functions
+- Never modify files in migrations/
+```
+
+Global memory lives at `~/.repopilot/REPOPILOT.md` and applies across all projects.
+
+## Configuration
+
+Config file: `~/.repopilot/config.toml`
+
+```toml
+[core]
+model = "openai/doubao-seed-evolving"
+api_key = "sk-..."
+base_url = "https://ark.cn-beijing.volces.com/api/v3"
+sandbox_type = "local"
+approval_mode = "auto"
+max_steps = 200
+budget_tokens = 500000
+tool_timeout = 120
+```
+
+Manage config via CLI:
+
+```bash
+repopilot config show
+repopilot config set model openai/gpt-4o
+repopilot config init  # re-run setup wizard
+repopilot models       # list recommended models
+```
+
+## Architecture
+
+```
+┌─────────────────────────────────┐
+│  CLI (Typer + Rich)    REPL     │
+├─────────────────────────────────┤
+│  Agent Loop (ReAct)             │
+├─────────────────────────────────┤
+│  Context Manager  L0-L5 memory  │
+├─────────────────────────────────┤
+│  Tool Registry + Permission     │
+├─────────────────────────────────┤
+│  Sandbox (Local / Docker)       │
+├─────────────────────────────────┤
+│  LLM Service (LiteLLM)          │
+└─────────────────────────────────┘
+```
+
+## Built-in Tools
+
+| Tool | Description |
+|------|-------------|
+| `read_file` | Read a file (with optional line range and offset limit) |
+| `write_file` | Write content to a file (creates or overwrites) |
+| `edit_file` | Find-and-replace edit (string replacement) |
+| `grep_search` | Search file contents with regex |
+| `glob` | Find files by glob pattern |
+| `list_dir` | List directory contents |
+| `repo_tree` | Show tree-sitter generated repository map |
+| `bash` | Execute a shell command (sandboxed) |
+| `run_python` | Execute Python code in an isolated temp file |
+| `finish` | Signal task completion and return to user |
+
+## Supported LLM Providers
+
+Any OpenAI-compatible endpoint works out of the box via [LiteLLM](https://docs.litellm.ai/):
+
+- **Volcengine ARK (Doubao)** — recommended, tested extensively
+- **OpenAI** (GPT-4o, GPT-4, o1, etc.)
+- **DeepSeek** (deepseek-chat, deepseek-reasoner)
+- **Alibaba Qwen** (qwen2.5-coder series)
+- **Zhipu GLM** (glm-4, glm-5 series)
+- **Local models** via vLLM / Ollama / llama.cpp (any OpenAI-compatible server)
+- **Anthropic Claude** (via LiteLLM)
+
+## License
+
+MIT — see [LICENSE](LICENSE) for details.
+
+## Acknowledgements
+
+Built after studying Claude Code (Anthropic), Codex CLI (OpenAI), and the SWE-bench / SWE-agent research.
+
+

repopilot_agent-0.1.0/pyproject.toml

@@ -0,0 +1,74 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "repopilot-agent"
+version = "0.1.0"
+description = "Local-first AI code agent in your terminal. Inspired by Claude Code and Codex CLI."
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+keywords = ["ai", "code-agent", "cli", "coding-assistant", "llm", "developer-tools"]
+authors = [
+    {name = "ZhangYang2297"},
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Code Generators",
+    "Topic :: Software Development :: Quality Assurance",
+]
+dependencies = [
+    "typer>=0.12",
+    "rich>=13",
+    "prompt-toolkit>=3.0",
+    "litellm>=1.40",
+    "openai>=1.30",
+    "docker>=7.0",
+    "tree-sitter>=0.21,<0.22",
+    "tree-sitter-python>=0.21,<0.22",
+    "pathspec>=0.12",
+    "structlog>=24.0",
+    "pyyaml>=6.0",
+    "jinja2>=3.1",
+    "httpx>=0.27",
+    "diskcache>=5.6",
+    "tomli>=2.0;python_version<\"3.11\"",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0",
+    "pytest-timeout",
+    "pytest-cov",
+    "ruff>=0.5",
+    "ipython",
+]
+
+[project.scripts]
+repopilot = "repopilot.cli:app"
+
+[project.urls]
+Homepage = "https://github.com/ZhangYang2297/repopilot"
+Repository = "https://github.com/ZhangYang2297/repopilot"
+Issues = "https://github.com/ZhangYang2297/repopilot/issues"
+
+[tool.setuptools.packages.find]
+include = ["repopilot*"]
+exclude = ["tests*", "eval*", "docs*"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py310"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP", "B"]
+
+

repopilot_agent-0.1.0/repopilot/__init__.py

@@ -0,0 +1,3 @@
+"""RepoPilot — Local-first code agent."""
+from __future__ import annotations
+__version__ = "0.1.0"

repopilot_agent-0.1.0/repopilot/__main__.py

@@ -0,0 +1,3 @@
+"""Allow running RepoPilot with: python -m repopilot"""
+from repopilot.cli import app
+app()