Skip to content
Back to search

peri

Lightweight Rust Agent only use 50MB RAM, but Claude Code Plugin compatible, Dynamic Workflow, Goal, Artifacts, Free Web Search, full feature and better support!

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/KonghaYao/peri with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/KonghaYao/peri'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/konghayao--peri/badge.svg)](/listings/konghayao--peri)

HTML

<a href="/listings/konghayao--peri"><img src="/api/listings/konghayao--peri/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 170 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <div align="center">
  2. <img src="images/img_peri_black_marble_banner_s03.webp" alt="Peri Code — All Coding for you." width="960">
  3. # Peri Code
  4. ### All Coding for you.
  5. A native Rust coding agent for macOS, Linux, and Windows.<br>
  6. Bring an Anthropic or OpenAI-compatible endpoint.
  7. [**Get started ↓**](#get-started) · [Documentation](https://konghayao.github.io/peri-cool/) · [Releases](https://github.com/konghayao/peri/releases)
  8. </div>
  9. ---
  10. <div align="center">
  11. **AGENTS, WORKING TOGETHER**
  12. Plan delivery. Coordinate agents. Delegate tasks.
  13. </div>
  14. <table>
  15. <tr>
  16. <td width="33%" valign="top">
  17. <h3>01 / Ultra-ADLC</h3>
  18. <strong>From idea to delivery.</strong>
  19. <p>Discover, design, review, build, and verify.</p>
  20. <code>/ultra-adlc</code>
  21. </td>
  22. <td width="33%" valign="top">
  23. <h3>02 / Ultracode</h3>
  24. <strong>Work as a team.</strong>
  25. <p>Run agents in parallel, choose their models, and track progress.</p>
  26. <code>/ultracode</code>
  27. </td>
  28. <td width="33%" valign="top">
  29. <h3>03 / Multitask <small>(Built-in)</small></h3>
  30. <strong>Delegate and keep talking.</strong>
  31. <p>Let agents work in the background while you stay in control.</p>
  32. <code>/multitask</code>
  33. </td>
  34. </tr>
  35. </table>
  36. <table>
  37. <tr>
  38. <td colspan="2">
  39. <h3>🔌 MCP Plus</h3>
  40. <strong>More than tools.</strong>
  41. <p>Load remote skills and agents on demand.</p>
  42. </td>
  43. </tr>
  44. <tr>
  45. <td width="50%" valign="top">
  46. <h3>🛠️ MetaHarness</h3>
  47. <strong>Make the agent yours.</strong>
  48. <p>Customize prompts, capabilities, and built-in agents.</p>
  49. </td>
  50. <td width="50%" valign="top">
  51. <h3>🧩 MCP Apps</h3>
  52. <strong>Connect interactive apps.</strong>
  53. <p>Use apps in a compatible ACP host, with Peri's tool permissions.</p>
  54. </td>
  55. </tr>
  56. <tr>
  57. <td valign="top">
  58. <h3>📄 Artifacts</h3>
  59. <strong>Share your results.</strong>
  60. <p>Publish HTML or Markdown reports as public links.</p>
  61. </td>
  62. <td valign="top">
  63. <h3>⏱️ Goals &amp; Automation</h3>
  64. <strong>Keep the work moving.</strong>
  65. <p>Track goals across turns and schedule recurring tasks while Peri runs.</p>
  66. </td>
  67. </tr>
  68. </table>
  69. <div align="center">
  70. **The essentials, included.**
  71. Streaming Markdown · Compaction · Langfuse<br>
  72. Skills & hooks · Plugins · Model profiles<br>
  73. Rewind · Fork · Resume<br>
  74. **Terminal · Headless · ACP**
  75. </div>
  76. ## Get started
  77. **macOS / Linux**
  78. ```bash
  79. curl -fsSL https://raw.githubusercontent.com/konghayao/peri/main/scripts/install.sh | bash
  80. ```
  81. 中国大陆用户可使用代理安装:
  82. ```bash
  83. curl -fsSL https://github-proxy-5ad00a.netlify.app/konghayao/peri/raw/main/scripts/install.sh \
  84. | GITHUB_PROXY=https://github-proxy-5ad00a.netlify.app \
  85. GITHUB_API_PROXY=https://github-proxy-5ad00a.netlify.app/api \
  86. bash
  87. ```
  88. 安装完成后,运行 `peri update --use-proxy` 通过同一代理更新。
  89. **Windows PowerShell**
  90. ```powershell
  91. irm https://raw.githubusercontent.com/konghayao/peri/main/scripts/install.ps1 | iex
  92. ```
  93. Also installable with [mise](https://mise.jdx.dev/) through the `github:KonghaYao/peri` tool;
  94. set `version_prefix = "agent-v"` to strip the release tag prefix.
  95. Follow the installer's PATH instructions, then run `peri` in your project. Complete model setup and restart Peri.
  96. ```bash
  97. peri # Start in your project
  98. peri -c # Continue your last session
  99. peri -p "Review this branch" # Run a task and exit
  100. peri update # Update Peri
  101. ```
  102. Tool calls are auto-approved by default. For approval prompts, use `--permission-mode default`.
  103. <details>
  104. <summary><strong>Configuration & runtime notes</strong></summary>
  105. - `/login`: providers · `/model`: model profiles · `/threads`: saved sessions.
  106. - Settings: `~/.peri/settings.json` (`--config-file`). Sessions: `~/.peri/threads/threads.db` (`--db-path`).
  107. - ACP client: `peri acp --cwd /path/to/project`.
  108. - Workflows require Node.js. Extensions may need other dependencies.
  109. - Claude Code compatibility varies by feature. Caching depends on your provider and workload.
  110. - Coordination uses skills and a shared runtime. MetaHarness changes apply to new sessions; MCP Apps needs a compatible host.
  111. Full options: `peri --help`. More: [Documentation](https://konghayao.github.io/peri-cool/).
  112. </details>
  113. <details>
  114. <summary><strong>Build & contribute</strong></summary>
  115. Requires Rust with Edition 2024 support and native build tools.
  116. ```bash
  117. git clone https://github.com/konghayao/peri.git
  118. cd peri
  119. ./dev.sh # 开发模式;读取仓库根 .env(可选)
  120. # 构建发布二进制:
  121. ./scripts/cargo-rmcp-patched.sh build --locked -p peri-tui --release --bin peri
  122. ```
  123. AI-assisted development, with human responsibility for review and release.
  124. [Repository guidance](CLAUDE.md) · [Architecture](docs/design/architecture.md) · [Code index](docs/code-index/) · [Standards](docs/standards/index.md) · [Testing](docs/standards/testing.md)
  125. </details>
  126. ---
  127. Built with [Ratatui](https://ratatui.rs), [ratatui-kit](https://github.com/KonghaYao/ratatui-kit), [Tokio](https://tokio.rs), [ACP](https://agentclientprotocol.com), and [Langfuse](https://langfuse.com). Thanks to [Claude Code Best](https://github.com/claude-code-best/claude-code), [Superpowers](https://github.com/obra/superpowers), and [Matt Pocock's Skills](https://github.com/mattpocock/skills).
  128. [Apache 2.0](LICENSE)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.