codpilot-cli 0.1.0__tar.gz

codpilot_cli-0.1.0/.claude/settings.local.json

@@ -0,0 +1,10 @@
+{
+  "permissions": {
+    "allow": [
+      "WebFetch(domain:pypi.org)",
+      "Bash(pip index:*)",
+      "Bash(pip install:*)",
+      "Bash(uv pip install:*)"
+    ]
+  }
+}

codpilot_cli-0.1.0/.gitignore

@@ -0,0 +1,12 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+.env*.local
+.DS_Store

codpilot_cli-0.1.0/.python-version

@@ -0,0 +1 @@
+3.14

codpilot_cli-0.1.0/PKG-INFO

@@ -0,0 +1,88 @@
+Metadata-Version: 2.4
+Name: codpilot-cli
+Version: 0.1.0
+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
+
+# CodePilot CLI
+
+A multi agent CLI tool that integrates with GitHub that can help you to review pull requests, create new features, and suggest changes on your behalf — all from your terminal.
+
+## Features
+
+**Review PR** — Analyzes the pull request and posts inline comments with suggestions.
+
+**Create Feature** — It can implements new features, then opens a draft pull request against the target repository.
+
+**Suggest Changes** — Participate in GitHub Issue discussions, analyze the codebase and conversation, and post technical suggestions as comments.
+
+## Available Commands
+
+| Command                        | Description                   |
+| ------------------------------ | ----------------------------- |
+| `codepilot run`                | Run the agent                 |
+| `codepilot reset-github-token` | Reset the stored GitHub token |
+| `codepilot change-llm`         | Change the LLM model          |
+| `codepilot --version, -v`      | Show the current version      |
+
+`codepilot run` has the following options:
+
+- Review PR
+- Create Feature
+- Suggest Changes
+
+## Prerequisites
+
+- Python 3.14+
+- A GitHub personal access token
+- An API key for at least one LLM provider (Gemini, OpenAI, or Anthropic)
+
+## Installing locally
+
+```bash
+git clone https://github.com/<your-username>/ai-coding-agent.git
+cd codepilot
+pip install -e .
+```
+
+Verify the installation:
+
+```bash
+codepilot --version
+```
+
+## Usage
+
+```bash
+codepilot 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 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` |

codpilot_cli-0.1.0/README.md

@@ -0,0 +1,67 @@
+# CodePilot CLI
+
+A multi agent CLI tool that integrates with GitHub that can help you to review pull requests, create new features, and suggest changes on your behalf — all from your terminal.
+
+## Features
+
+**Review PR** — Analyzes the pull request and posts inline comments with suggestions.
+
+**Create Feature** — It can implements new features, then opens a draft pull request against the target repository.
+
+**Suggest Changes** — Participate in GitHub Issue discussions, analyze the codebase and conversation, and post technical suggestions as comments.
+
+## Available Commands
+
+| Command                        | Description                   |
+| ------------------------------ | ----------------------------- |
+| `codepilot run`                | Run the agent                 |
+| `codepilot reset-github-token` | Reset the stored GitHub token |
+| `codepilot change-llm`         | Change the LLM model          |
+| `codepilot --version, -v`      | Show the current version      |
+
+`codepilot run` has the following options:
+
+- Review PR
+- Create Feature
+- Suggest Changes
+
+## Prerequisites
+
+- Python 3.14+
+- A GitHub personal access token
+- An API key for at least one LLM provider (Gemini, OpenAI, or Anthropic)
+
+## Installing locally
+
+```bash
+git clone https://github.com/<your-username>/ai-coding-agent.git
+cd codepilot
+pip install -e .
+```
+
+Verify the installation:
+
+```bash
+codepilot --version
+```
+
+## Usage
+
+```bash
+codepilot 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 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` |

codpilot_cli-0.1.0/app/agents/feature_agent.py

@@ -0,0 +1,49 @@
+from google.adk.agents.llm_agent import LlmAgent
+from google.adk.agents.loop_agent import LoopAgent
+from google.adk.tools.tool_context import ToolContext
+from app.agents.tools.github_mcp import github_mcp
+from app.services.build_model_service import build_model
+
+
+def finish_task(tool_context: ToolContext):
+    """Call this ONLY when a Pull Request URL has been successfully generated."""
+    tool_context.actions.escalate = True
+    return {"status": "complete"}
+
+
+base_feature_agent = LlmAgent(
+    name="CodeAnalyzerAgent",
+    model=build_model(),
+    instruction="""
+    You are a coding agent.
+    1. Analyze the repo. 2. Make changes. 3. Raise a Draft Pull Request.
+
+    IMPORTANT: If the chat history shows you already modified files but missed the PR,
+    skip the analysis and call the PR tool immediately.
+    """,
+    output_key="worker_output",
+    tools=[github_mcp()],
+)
+
+verifier_agent = LlmAgent(
+    name="CodeVerifierAgent",
+    model=build_model(),
+    instruction="""
+    Review the following output from the CodeAnalyzer:
+
+    \"\"\"
+    {{worker_output}}
+    \"\"\"
+
+    Task:
+    - If a GitHub Pull Request URL is visible above, call 'finish_task' immediately.
+    - If NO Pull Request URL is found, explicitly tell the worker: 'You failed to create a PR. Please execute the PR tool now.'
+    """,
+    tools=[finish_task],
+)
+
+feature_agent = LoopAgent(
+    name="PrGenerationAgent",
+    sub_agents=[base_feature_agent, verifier_agent],
+    max_iterations=3,
+)

codpilot_cli-0.1.0/app/agents/pr_review_agent.py

@@ -0,0 +1,70 @@
+from google.adk.agents.llm_agent import LlmAgent
+from app.agents.tools.github_mcp import github_mcp
+from app.services.build_model_service import build_model
+from google.adk.tools.tool_context import ToolContext
+from google.adk.agents.loop_agent import LoopAgent
+
+
+def finish_review(tool_context: ToolContext):
+    """Call this ONLY when the final PR summary and recommendation (Approve/Request Changes) have been posted."""
+    tool_context.actions.escalate = True
+    return {"status": "review_submitted"}
+
+
+base_review_agent = LlmAgent(
+    name="PullRequestReviewWorker",
+    model=build_model(),
+    instruction="""
+        You are a senior software engineer.
+
+        TASK:
+        1. Use github_mcp to get the PR diff.
+        2. Review files one by one.
+        3.  Identify issues in:
+            - Correctness
+            - Edge cases
+            - Security
+            - Performance
+            - Readability & maintainability
+            - Architecture & consistency
+            - Tests (missing or insufficient)
+        4. For each issue, use the 'post_inline_comment' tool.
+
+        RULES
+        - NO POSITIVE FEEDBACK: Never post "Good," "Consistent," or "Correct." If code is good, skip it.
+        - NO CHATTER: Do not explain your process.
+        - For code improvement comment must include a ```suggestion``` block.
+
+        IMPORTANT: Check the chat history. If you have already commented on certain files,
+        DO NOT repeat them. Move to the next file in the diff.
+
+        When finished with ALL files, provide a 'Final Summary' and call the tool to submit the overall review.
+        """,
+    output_key="review_output",
+    tools=[github_mcp()],
+)
+
+review_verifier_agent = LlmAgent(
+    name="ReviewVerifierAgent",
+    model=build_model(),
+    instruction="""
+        You are an auditor. Examine the 'review_output' provided below:
+
+        REVIEW_LOG:
+        {{review_output}}
+
+        CHECKLIST:
+        - Did the worker post a final summary? (Yes/No)
+        - Did the worker submit a formal recommendation (Approve/Reject)? (Yes/No)
+
+        IF BOTH ARE YES: Call 'finish_review' immediately.
+        IF NO: Tell the worker exactly what is missing (e.g., 'You reviewed the files but forgot to submit the final Approval').
+    """,
+    tools=[finish_review],
+)
+
+pr_review_agent = LoopAgent(
+    name="AutonomousPrReviewer",
+    sub_agents=[base_review_agent, review_verifier_agent],
+    max_iterations=5,
+)

codpilot_cli-0.1.0/app/agents/suggestion_agent.py

@@ -0,0 +1,59 @@
+from google.adk.agents.llm_agent import LlmAgent
+from google.adk.agents.loop_agent import LoopAgent
+from google.adk.tools.tool_context import ToolContext
+from app.agents.tools.github_mcp import github_mcp
+from app.services.build_model_service import build_model
+
+
+def finish_discussion(tool_context: ToolContext):
+    """Signals that the agent has successfully contributed to the discussion."""
+    tool_context.actions.escalate = True
+    return {"status": "contribution_posted"}
+
+
+base_agent = LlmAgent(
+    name="IssueAdvisorAgent",
+    model=build_model(),
+    instruction="""
+    You are a Technical Advisor specializing in GitHub Issues. Your goal is to provide deep technical insights on reported problems or feature requests.
+
+    STEP 1: GATHER CONTEXT
+    - Fetch the Issue description and ALL existing comments.
+    - Search the codebase using relevant keywords from the issue to identify the specific files or functions involved.
+
+    STEP 2: ANALYZE
+    - Evaluate if the reported issue is a bug, a performance bottleneck, or a feature request.
+    - Propose a technical strategy or root cause analysis based on the codebase search.
+    - Acknowledge any previous comments to maintain a collaborative tone.
+
+    STEP 3: POST COMMENT
+    - Use the GitHub MCP tool to post your technical findings as a comment.
+
+    STRICT RULES:
+    - Do not look at Pull Requests. Never modify files or create branches.
+    - Do not offer to draft code changes.
+    """,
+    output_key="worker_output",
+    tools=[github_mcp()],
+)
+
+verifier_agent = LlmAgent(
+    name="ActionVerifier",
+    model=build_model(),
+    instruction="""
+    Review the 'worker_output'.
+
+    If the output mentions it is a Pull Request:
+       - Immediately call 'finish_discussion' to stop the loop.
+    If the text indicates a GitHub comment was successfully submitted via a tool call, run 'finish_discussion'.
+    If the text contains a technical analysis but NO evidence of a tool call (like 'comment_posted'),
+    explicitly command the agent: 'I see your analysis. You must now use the GitHub MCP tool to post this as a comment on the issue.'
+    """,
+    tools=[finish_discussion],
+)
+
+suggestion_agent = LoopAgent(
+    name="DiscussionAgent",
+    sub_agents=[base_agent, verifier_agent],
+    max_iterations=2,
+)

codpilot_cli-0.1.0/app/agents/tools/github_mcp.py

@@ -0,0 +1,23 @@
+import keyring
+from google.adk.tools.mcp_tool import McpToolset
+from google.adk.tools.mcp_tool.mcp_session_manager import StreamableHTTPServerParams
+
+MCP_URL = "https://api.githubcopilot.com/mcp/"
+SERVICE_NAME = "github-agent"
+TOKEN_KEY = "github_token"
+
+
+def github_mcp():
+    token = keyring.get_password(SERVICE_NAME, TOKEN_KEY)
+
+    return McpToolset(
+        connection_params=StreamableHTTPServerParams(
+            timeout=120,
+            url=MCP_URL,
+            headers={
+                "Authorization": f"Bearer {token}",
+                "X-MCP-Toolsets": "all",
+                "X-MCP-Readonly": "false",
+            },
+        ),
+    )

codpilot_cli-0.1.0/app/cli/commands/run.py

@@ -0,0 +1,44 @@
+from app.workflows.agent_workflow import agent_workflow
+import typer
+import asyncio
+from app.cli.inputs import (
+    ask_repo_url,
+    ask_agent_type,
+    ask_llm_model,
+    ask_github_token,
+)
+from app.cli.llm import ask_llm_token
+from rich.console import Console
+from rich.panel import Panel
+from rich import box
+from importlib.metadata import version
+from app.cli.spinner import run_with_spinner
+
+console = Console()
+
+
+def run():
+    console.print(
+        Panel(
+            f"[bold cyan]CodPilot[/bold cyan] [green]v{version('codpilot')}[/green]\n"
+            "[dim]Autonomous coding agent for GitHub[/dim]",
+            box=box.DOUBLE,
+            border_style="cyan",
+            padding=(1, 4),
+        )
+    )
+    agent_type, description = ask_agent_type()
+    repo_url = ask_repo_url(agent_type)
+    model = ask_llm_model()
+    ask_llm_token(model)
+    ask_github_token()
+
+    asyncio.run(
+        run_with_spinner(
+            agent_workflow(
+                repo_url=repo_url, agent_type=agent_type, description=description
+            )
+        )
+    )
+
+    typer.echo("✅ Execution completed")

codpilot_cli-0.1.0/app/cli/commands/version.py

@@ -0,0 +1,8 @@
+import typer
+from importlib.metadata import version
+
+
+def version_callback(value: bool):
+    if value:
+        typer.echo(f"codpilot v{version('ai-coding-agent')}")
+        raise typer.Exit()

codpilot_cli-0.1.0/app/cli/inputs.py

@@ -0,0 +1,164 @@
+import questionary
+import keyring
+import requests
+import time
+import typer
+
+from app.cli.llm import ask_llm_token
+
+WORKFLOW_OPTIONS = {
+    "review_pr": "Review PR",
+    "create_feature": "Create a new feature",
+    "suggest_changes": "Add your suggestions to the Issue",
+}
+LLM_MODELS = ["Gemini", "OpenAI", "Anthropic"]
+SERVICE_NAME = "github-agent"
+LLM_MODEL_KEY = "llm_model"
+LLM_TOKEN_KEY = "llm_api_token"
+
+
+def ask_repo_url(agent_type):
+    if agent_type == "create_feature":
+        msg = "Enter the GitHub repository URL:"
+    elif agent_type == "suggest_changes":
+        msg = "Enter the GitHub Issue URL:"
+    else:
+        msg = "Enter the GitHub PR URL:"
+
+    repo_url = questionary.text(
+        msg,
+    ).ask()
+
+    if not repo_url:
+        typer.echo("⛔️ URL is required")
+        raise SystemExit(1)
+
+    if not repo_url.startswith("https://github.com/"):
+        typer.echo("⛔️ Invalid URL")
+        raise SystemExit(1)
+
+    return repo_url
+
+
+def ask_agent_type():
+    choice = questionary.select(
+        "Select mode:",
+        choices=[
+            questionary.Choice(title=label, value=key)
+            for key, label in WORKFLOW_OPTIONS.items()
+        ],
+    ).ask()
+
+    if not choice:
+        typer.echo("Mode is required")
+        raise SystemExit(1)
+
+    description = None
+    if choice == "create_feature":
+        description = questionary.text(
+            "Enter the details of the feature you want to create:",
+        ).ask()
+
+        if not description:
+            typer.echo("Description is required")
+            raise SystemExit(1)
+
+    return choice, description
+
+
+def ask_llm_model():
+    selected_model = keyring.get_password(SERVICE_NAME, LLM_MODEL_KEY)
+
+    if selected_model:
+        typer.echo(f"Using LLM model {selected_model}")
+        return selected_model
+
+    model = questionary.select(
+        "Select LLM model:",
+        choices=LLM_MODELS,
+    ).ask()
+
+    if not model:
+        typer.echo("LLM model is required")
+        raise SystemExit(1)
+
+    keyring.set_password(SERVICE_NAME, LLM_MODEL_KEY, model)
+
+    return model
+
+
+def ask_github_token():
+    token = keyring.get_password(SERVICE_NAME, "github_token")
+
+    if token:
+        return
+
+    token = questionary.password("Enter your GitHub API token:").ask()
+
+    if not token:
+        typer.echo("⛔️ GitHub token is required")
+        raise SystemExit(1)
+
+    if _validate_github_token(token):
+        keyring.set_password(SERVICE_NAME, "github_token", token)
+        time.sleep(1)
+    else:
+        typer.echo("⛔️ Invalid GitHub token")
+        raise SystemExit(1)
+
+
+def reset_github_token():
+    existing = keyring.get_password(SERVICE_NAME, "github_token")
+
+    if not existing:
+        typer.echo("⚠️ No GitHub token found in keyring.")
+        return
+
+    confirm = questionary.confirm(
+        "Are you sure you want to reset the stored GitHub token?"
+    ).ask()
+
+    if not confirm:
+        typer.echo("ℹ️ Token reset cancelled.")
+        return
+
+    keyring.delete_password(SERVICE_NAME, "github_token")
+    typer.echo("🗑️ GitHub token removed.")
+
+    ask_github_token()
+    typer.echo("GitHub token has been reset successfully.")
+
+
+def change_llm_model():
+    existing = keyring.get_password(SERVICE_NAME, LLM_MODEL_KEY)
+
+    if not existing:
+        typer.echo("⚠️ No LLM model found.")
+        return
+
+    confirm = questionary.confirm(
+        "Are you sure you want to change the LLM model?"
+    ).ask()
+
+    if not confirm:
+        typer.echo("ℹ️ Change LLM model cancelled.")
+        return
+
+    keyring.delete_password(SERVICE_NAME, LLM_MODEL_KEY)
+    model = ask_llm_model()
+    if keyring.get_password(SERVICE_NAME, LLM_TOKEN_KEY):
+        keyring.delete_password(SERVICE_NAME, LLM_TOKEN_KEY)
+
+    ask_llm_token(model)
+
+
+def _validate_github_token(token: str) -> bool:
+    try:
+        resp = requests.get(
+            "https://api.github.com/user",
+            headers={"Authorization": f"Bearer {token}"},
+            timeout=5,
+        )
+        return resp.status_code == 200
+    except requests.RequestException:
+        return False