pedalpoint 0.1.0

MCP server that routes mechanical dev tasks to a local LLM

pedalpoint

Route mechanical development tasks to a local LLM (Ollama, LM Studio, Jan) via Claude Code. Automatically falls back to local-only mode when Claude quota is exhausted.

What it does

• Hybrid routing: Claude classifies each task. Mechanical work (scaffolding, CRUD, test stubs) goes to your local LLM. Judgment work (architecture, debugging, integration) stays with Claude.
• Quota fallback: When Claude returns a quota error, pedalpoint automatically switches to local-only mode and continues working. Switches back when quota restores.
• Context Courier: Before sending any task to the local LLM, pedalpoint greps your codebase for existing patterns and injects them into the prompt. Local LLMs only get tasks they have templates for.
• Single install: One script installs the MCP server, pulls the default model, and registers the companion skill.

Requirements

• Claude Code
• Python 3.11+
• Ollama (or any OpenAI-compatible inference server)

Install

curl -fsSL https://raw.githubusercontent.com/EMSwank/pedalpoint/main/install.sh | sh

With a custom model or endpoint:

curl -fsSL https://raw.githubusercontent.com/EMSwank/pedalpoint/main/install.sh | \
  sh -s -- --model llama3 --base-url http://localhost:11434/v1

Restart Claude Code after install.

Usage

Instead of superpowers:subagent-driven-development, invoke:

pedalpoint:route-tasks

pedalpoint handles routing automatically. No manual flagging needed.

Modes

Mode	Set via	Behavior
hybrid	default	Claude classifies each task
local-only	PEDALPOINT_MODE=local-only	All tasks → local LLM (use when quota exhausted preemptively)
passthrough	PEDALPOINT_MODE=passthrough	All tasks → Claude Agent (disables pedalpoint)

Configuration

Variable	Default	Description
PEDALPOINT_BASE_URL	http://localhost:11434/v1	OpenAI-compatible endpoint
PEDALPOINT_MODEL	gemma4:e4b	Default local model
PEDALPOINT_MODE	hybrid	Routing mode
PEDALPOINT_TIMEOUT	120	Read timeout in seconds
PEDALPOINT_INITIAL_FALLBACK_MINUTES	60	Initial circuit-open duration (doubles on each probe failure)

Uninstall

curl -fsSL https://raw.githubusercontent.com/EMSwank/pedalpoint/main/install.sh | sh -s -- --uninstall

Development

git clone https://github.com/EMSwank/pedalpoint
cd pedalpoint
pip install -e ".[dev]"   # requires pip >= 21.3; run `pip install --upgrade pip` if needed
pytest tests/unit/ -v

Integration tests (requires Ollama running):

PEDALPOINT_INTEGRATION=true pytest tests/integration/ -v

Install script tests (requires bats-core):

brew install bats-core   # macOS; use apt-get install bats on Linux
bats tests/install/

License

MIT