Metadata-Version: 2.4
Name: codpilot
Version: 0.1.3
Summary: A multi-agent CLI tool that integrates with GitHub to review PRs, create features, and suggest changes.
License-Expression: MIT
Keywords: cli,codpilot,github
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Software Development :: Quality Assurance
Requires-Python: >=3.14
Requires-Dist: google-adk>=1.24.0
Requires-Dist: keyring>=25.7.0
Requires-Dist: litellm>=1.81.11
Requires-Dist: python-dotenv>=1.2.1
Requires-Dist: questionary>=2.1.1
Requires-Dist: rich>=14.3.2
Requires-Dist: typer>=0.23.1
Description-Content-Type: text/markdown

# CodPilot CLI

![codpilot](https://img.shields.io/pypi/v/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](https://github.com/google/adk-python) and [GitHub MCP](https://github.com/github/github-mcp-server).

## Quick Install

```bash
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)](https://github.com/settings/tokens)
2. Click **Generate new token** > **Generate new token (classic)**

## Usage

```bash
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

```bash
git clone https://github.com/paulsojan/codpilot-cli.git
cd codpilot-cli
pip install -e .
```

Verify the installation:

```bash
codpilot --version
```
