A native Rust coding agent for macOS, Linux, and Windows.
Bring an Anthropic or OpenAI-compatible endpoint.
AGENTS, WORKING TOGETHER
Plan delivery. Coordinate agents. Delegate tasks.
|
From idea to delivery.
Discover, design, review, build, and verify. /ultra-adlc
|
Work as a team.
Run agents in parallel, choose their models, and track progress. /ultracode
|
Delegate and keep talking.
Let agents work in the background while you stay in control. /multitask
|
|
More than tools.
Load remote skills and agents on demand. Exchange messages and approvals through compatible channels. |
|
|
Make the agent yours.
Customize prompts, capabilities, and built-in agents. |
Connect interactive apps.
Use apps in a compatible ACP host, with Peri's tool permissions. |
|
Share your results.
Publish HTML or Markdown reports as public links. |
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
macOS / Linux
curl -fsSL https://raw.githubusercontent.com/konghayao/peri/main/scripts/install.sh | bashWindows PowerShell
irm https://raw.githubusercontent.com/konghayao/peri/main/scripts/install.ps1 | iexFollow 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 PeriTool 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-tuiAI-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.