A multi-agent CLI tool that integrates with GitHub to review PRs, create features, and suggest changes.
Project description
CodPilot CLI
A multi-agent CLI tool that connects to your GitHub account to review pull requests, create new features, and contribute to issue discussions — all directly from your terminal.
Built with Google ADK and GitHub MCP.
Quick Install
pip install codpilot
Key Features
Review PR — Analyzes a pull request and posts inline code review comments with suggestions.
Create Feature — Analyzes the existing codebase, implements a described feature, and opens a draft pull request.
Add Suggestions to Issue — Reads a GitHub Issue discussion, analyzes the codebase, and posts technical suggestions as comments.
Available Commands
| Command | Description |
|---|---|
codpilot run |
Run the agent |
codpilot reset-github-token |
Reset the stored GitHub token |
codpilot change-llm |
Change the LLM model |
codpilot --version, -v |
Show the current version |
Prerequisites
- Python 3.14+
- A GitHub personal access token
- An API key for at least one LLM provider (Gemini, OpenAI, or Anthropic)
Creating a GitHub Personal Access Token (Classic)
- Go to GitHub Settings > Developer settings > Personal access tokens > Tokens (classic)
- Click Generate new token > Generate new token (classic)
Usage
codpilot run
The interactive prompt will walk you through:
- Selecting an agent (Review PR / Create Feature / Suggest Changes)
- Entering the GitHub URL (PR, repository, or issue depending on the agent)
- Choosing an LLM provider (Gemini / OpenAI / Anthropic)
- Providing API credentials for GitHub and the LLM (cached in your system keychain for future runs)
Supported Models
| Provider | Model |
|---|---|
| Gemini | gemini-3-flash-preview |
| OpenAI | gpt-5-mini |
| Anthropic | claude-3-7-sonnet-20250219 |
Development Setup
git clone https://github.com/paulsojan/codpilot-cli.git
cd codpilot-cli
pip install -e .
Verify the installation:
codpilot --version
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file codpilot-0.1.3.tar.gz.
File metadata
- Download URL: codpilot-0.1.3.tar.gz
- Upload date:
- Size: 99.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.9.21 {"installer":{"name":"uv","version":"0.9.21","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ae057474b5eca543f93746cd301b951f0a675f1b0d0c845809157a82433c175e
|
|
| MD5 |
e043406d2a4f693b7d843bdf289d4254
|
|
| BLAKE2b-256 |
f58933c14e3521ea493efe7dabc7e0446f12f18fc6828011ea5749ed6e4905d4
|
File details
Details for the file codpilot-0.1.3-py3-none-any.whl.
File metadata
- Download URL: codpilot-0.1.3-py3-none-any.whl
- Upload date:
- Size: 12.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.9.21 {"installer":{"name":"uv","version":"0.9.21","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
3f7dc147f3af0c01bb3ba91a90ebd420b107f19ec8276f2f9bf6cf89f3c256a5
|
|
| MD5 |
cf3b8144dde1bd41e63b4339aac33604
|
|
| BLAKE2b-256 |
edef5c70499ffe6f64f23c9c94dc94634498fcbc82c0883d8d255f177b857694
|