rpi — reference manual

rpi is a terminal coding agent for Pi v3 sessions: a single Rust binary that switches between print mode, a line REPL, a full-screen inline TUI, and headless JSON/RPC modes. It supports multiple model providers, local llama.cpp models, extensions, skills, prompt templates, packages, session export and sharing, a security model built around project trust and credential redaction, and a full orchestration stack: durable goals, Todo DAGs, subagent jobs with IRC coordination, isolated concurrent workflows, MCP/ACP protocol clients, voice input, memory backends, and host hooks.

Getting started

• Quick start — first-run workflow
• Installation — supported platforms, installers, verification

User guide

• TUI and keybindings
• CLI modes and commands
• Goals
• Todos and the Todo DAG
• Orchestration: subagents, jobs, and IRC
• Isolated concurrent workflows
• Session recovery: rewind, checkpoints, handoffs, and TTL
• Live voice (/live)
• Models and custom providers
• Authentication
• RPC JSONL protocol
• Web client (/web)
• E2E scenarios (user-perspective tmux tests)

Reference

• Settings, configuration, and trust
• Configuration profiles, TOML settings, and scoped auth
• Environment variables
• Sandbox and overlayfs isolation
• Hooks and trust hooks
• Extensions and process protocol
• Skills
• Packages
• Memory
• Extended tool catalog
• Model Context Protocol (MCP) client
• Agent Client Protocol (ACP) mode
• Prompt templates and system prompt assembly
• Local / self-hosted models with llama.cpp
• Security
• Export and share
• Update safety