PocketCoder

CLI coding assistant supporting Ollama, OpenAI, Claude.

Features session persistence, multi-step task planning, project-aware context (RepoMap), and interactive file editing with human-in-the-loop approval.

Quick Start

pip install pocketcoder
pocketcoder

# Install Ollama: https://ollama.com
ollama pull qwen2.5-coder:7b
pocketcoder

export OPENAI_API_KEY="sk-..."
pocketcoder --provider openai --model gpt-4o

Key Features

• Multi-provider — Ollama, OpenAI, Anthropic, vLLM, LM Studio
• Session memory — agent remembers context across requests
• Task planning — TODO tracking with automatic breakdown
• RepoMap — project structure awareness for better context
• Human-in-the-loop — approve/reject every file change
• Offline capable — works fully local with Ollama

Demo: Building a Calculator

Ask PocketCoder to create a GUI calculator — it plans, asks clarifying questions, writes code, and runs it:

Agent reasons about the task and asks what type of calculator you need

Shows code preview before writing — you approve with [y] or skip with [n]

Result: working tkinter calculator created and executed

Features

Session Memory

Agent remembers what you're working on across requests. No need to re-explain context.

Project Awareness

RepoMap shows your codebase structure to the LLM. Agent knows your file layout.

Multi-step Tasks

TODO tracking with automatic planning. Agent breaks complex tasks into steps.

SESSION_CONTEXT: what the LLM sees about your project

Human-in-the-loop

Every file write requires your approval. Ask questions, reject changes, cancel tasks.

Full control: reject changes, explain why, cancel entire task

Architecture

Commands

Type / to see all commands:

Supported Providers

Recommended Models

For local use with 16GB+ RAM:

Configuration

Config stored in ~/.pocketcoder/config.yaml:

provider:
  type: ollama
  base_url: http://localhost:11434
  default_model: qwen2.5-coder:7b

thinking:
  mode: smart           # smart | always | never
  show_reasoning: true  # show agent's thinking process

Project Structure

PocketCoder stores session data in .pocketcoder/ directory:

.pocketcoder/
  project_context.json  # Current session state
  episodes.jsonl        # Conversation history
  memory.json           # Long-term facts

Development

git clone https://github.com/Chashchin-Dmitry/pocketcoder.git
cd pocketcoder
pip install -e ".[dev]"
pytest

Support the Project

If PocketCoder saves you money on AI subscriptions, consider supporting development:

License

MIT License