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. |
|
|
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 · Langfuse
Skills & hooks · Plugins · Model profiles
Rewind · Fork · Resume
Terminal · Headless · ACP
macOS / Linux
curl -fsSL https://raw.githubusercontent.com/konghayao/peri/main/scripts/install.sh | bash中国大陆用户可使用代理安装：
curl -fsSL https://github-proxy-5ad00a.netlify.app/konghayao/peri/raw/main/scripts/install.sh \
| GITHUB_PROXY=https://github-proxy-5ad00a.netlify.app \
GITHUB_API_PROXY=https://github-proxy-5ad00a.netlify.app/api \
bash安装完成后，运行 peri update --use-proxy 通过同一代理更新。
Windows PowerShell
irm https://raw.githubusercontent.com/konghayao/peri/main/scripts/install.ps1 | iexAlso installable with mise through the github:KonghaYao/peri tool;
set version_prefix = "agent-v" to strip the release tag prefix.
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 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. - 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
./dev.sh # 开发模式；读取仓库根 .env（可选）
# 构建发布二进制：
./scripts/cargo-rmcp-patched.sh build --locked -p peri-tui --release --bin periAI-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.