Peri Code

All Coding for you.

A native Rust coding agent for macOS, Linux, and Windows.
Bring an Anthropic or OpenAI-compatible endpoint.

Get started ↓ · Documentation · Releases

AGENTS, WORKING TOGETHER

Plan delivery. Coordinate agents. Delegate tasks.

01 / Ultra-ADLC

From idea to delivery.

Discover, design, review, build, and verify.

/ultra-adlc

02 / Ultracode

Work as a team.

Run agents in parallel, choose their models, and track progress.

/ultracode

03 / Multitask (Built-in)

Delegate and keep talking.

Let agents work in the background while you stay in control.

/multitask

🔌 MCP Plus

More than tools.

Load remote skills and agents on demand. Exchange messages and approvals through compatible channels.

🛠️ MetaHarness

Make the agent yours.

Customize prompts, capabilities, and built-in agents.

🧩 MCP Apps

Connect interactive apps.

Use apps in a compatible ACP host, with Peri's tool permissions.

📄 Artifacts

Share your results.

Publish HTML or Markdown reports as public links.

⏱️ Goals & Automation

Keep the work moving.

Track goals across turns and schedule recurring tasks while Peri runs.

The essentials, included.

Streaming Markdown · Compaction · LSP · Langfuse
Skills & hooks · Plugins · Model profiles
Rewind · Fork · Resume
Terminal · Headless · ACP · Web PTY

Get started

macOS / Linux

curl -fsSL https://raw.githubusercontent.com/konghayao/peri/main/scripts/install.sh | bash

Windows PowerShell

irm https://raw.githubusercontent.com/konghayao/peri/main/scripts/install.ps1 | iex

Follow the installer's PATH instructions, then run peri in your project. Complete model setup and restart Peri.

peri                         # Start in your project
peri -c                      # Continue your last session
peri -p "Review this branch"  # Run a task and exit
peri update                  # Update Peri

Tool calls are auto-approved by default. For approval prompts, use --permission-mode default.

Configuration & runtime notes

/login: providers · /model: model profiles · /threads: saved sessions.
Settings: ~/.peri/settings.json (--config-file). Sessions: ~/.peri/threads/threads.db (--db-path).
ACP client: peri acp --cwd /path/to/project. Browser terminal: peri web --host 127.0.0.1.
Workflows require Node.js. Extensions may need other dependencies.
Claude Code compatibility varies by feature. Caching depends on your provider and workload.
Coordination uses skills and a shared runtime. MetaHarness changes apply to new sessions; MCP Apps needs a compatible host.

Full options: peri --help. More: Documentation.

Build & contribute

Requires Rust with Edition 2024 support and native build tools.

git clone https://github.com/konghayao/peri.git
cd peri
cargo build -p peri-tui --release
cargo run -p peri-tui

AI-assisted development, with human responsibility for review and release.

Repository guidance · Architecture · Code index · Standards · Testing

Built with Ratatui, ratatui-kit, Tokio, ACP, and Langfuse. Thanks to Claude Code Best, Superpowers, and Matt Pocock's Skills.

Apache 2.0

peri

Links

README