Skip to main content

A multi-agent CLI tool that integrates with GitHub to review PRs, create features, and suggest changes.

Project description

CodPilot CLI

codpilot

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)

  1. Go to GitHub Settings > Developer settings > Personal access tokens > Tokens (classic)
  2. Click Generate new token > Generate new token (classic)

Usage

codpilot run

The interactive prompt will walk you through:

  1. Selecting an agent (Review PR / Create Feature / Suggest Changes)
  2. Entering the GitHub URL (PR, repository, or issue depending on the agent)
  3. Choosing an LLM provider (Gemini / OpenAI / Anthropic)
  4. 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

codpilot-0.1.3.tar.gz (99.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

codpilot-0.1.3-py3-none-any.whl (12.2 kB view details)

Uploaded Python 3

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

Hashes for codpilot-0.1.3.tar.gz
Algorithm Hash digest
SHA256 ae057474b5eca543f93746cd301b951f0a675f1b0d0c845809157a82433c175e
MD5 e043406d2a4f693b7d843bdf289d4254
BLAKE2b-256 f58933c14e3521ea493efe7dabc7e0446f12f18fc6828011ea5749ed6e4905d4

See more details on using hashes here.

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

Hashes for codpilot-0.1.3-py3-none-any.whl
Algorithm Hash digest
SHA256 3f7dc147f3af0c01bb3ba91a90ebd420b107f19ec8276f2f9bf6cf89f3c256a5
MD5 cf3b8144dde1bd41e63b4339aac33604
BLAKE2b-256 edef5c70499ffe6f64f23c9c94dc94634498fcbc82c0883d8d255f177b857694

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page