patchllm 1.0.0

About

PatchLLM is an interactive command-line agent that helps you modify your codebase. It uses an LLM to plan and execute changes, allowing you to review and approve every step.

Key Features

• Interactive Planning: The agent proposes a step-by-step plan before writing any code. You stay in control.
• Dynamic Context: Build and modify the code context on-the-fly using powerful scope definitions (@git:staged, @dir:src, etc.).
• Mobile-First TUI: A clean, command-driven interface with autocompletion makes it easy to use on any device.
• Resilient Sessions: Automatically saves your progress so you can resume if you get disconnected.

Getting Started

1. Initialize a configuration file (optional): This creates a scopes.py file to define reusable file collections.

patchllm --init

2. Start the Agent: Running patchllm with no arguments drops you into the interactive agentic TUI.

patchllm

3. Follow the Agent Workflow: Inside the TUI, you direct the agent with simple slash commands.

# 1. Set the goal
>>> /task Add a health check endpoint to the API

# 2. Build the context
>>> /context @dir:src/api

# 3. Ask the agent to generate a plan
>>> /plan
1. Add a new route `/health` to `src/api/routes.py`.
2. Implement the health check logic to return a 200 OK status.

# 4. Execute the first step and review the proposed changes
>>> /run

# 5. If the changes look good, approve them
>>> /approve

Agent Commands (TUI)

Headless Mode Flags

For scripting or single-shot edits, you can still use the original flags.

Setup

PatchLLM uses LiteLLM. Set up your API keys (e.g., OPENAI_API_KEY, GEMINI_API_KEY) in a .env file.

The interactive TUI requires prompt_toolkit and InquirerPy. You can install all core dependencies with:```bash pip install -r requirements.txt

Optional features require extra dependencies:
```bash
# For URL support in scopes
pip install "patchllm[url]"

# For voice commands (in headless mode)
pip install "patchllm[voice]"

License

This project is licensed under the MIT License.