MusePi — a fork of pi that grew into its own agent

01What MusePi adds over upstream pi相比上游 pi，MusePi 多出什么

Differences live in packages/musepi/ and the TUI seam of the coding agent; upstream tracks the agent/tool layer, so the fork stays cheap to maintain. 差异集中在 packages/musepi/ 与 coding agent 的 TUI 接缝；上游演进集中在 agent/工具层，fork 的维护成本因此保持低位。

hashline editing@musepi/core/hashline: Hash-anchored edit format for robust, retryable file edits — weaker models stop corrupting files with fuzzy diffs.哈希锚定的编辑格式，文件修改稳健可重试—— 弱模型不再用模糊 diff 改坏文件。
long-term memory@musepi/core/memory · /memory: MiMo-style markdown memory: project + global MEMORY.md files, BM25 recall, a memory tool (search/retain/edit) and a budgeted startup injection. Inspect and manage with /memory — view/stats/clear, with enable/disable hot-switching the live session.MiMo 式 Markdown 记忆：项目级 + 全局 MEMORY.md、 BM25 召回、memory 工具（search/retain/edit）与预算化启动注入。用 /memory 查看与管理——view/stats/clear，enable/disable 热切换当前会话。
grouped settings panelsettings · MusePi submenu: Section headings with type-to-search, and a dedicated MusePi submenu exposing all 42 musepi.* settings across nine groups (Memory, MCP, LSP, Advisor, Model Roles, Tools, Swarm, Interface, Updates & Compat).分组标题 + 模糊搜索，独立的 MusePi 子菜单暴露全部 42 项 musepi.* 设置，覆盖九个分组（Memory、MCP、LSP、Advisor、 Model Roles、Tools、Swarm、Interface、Updates & Compat）。
native advisor & MCPadvisor · /mcp: A second-opinion advisor wired natively into the agent loop, and first-class MCP server support with lazy stdio/http connections, managed from the /mcp command.原生接入 agent 循环的"第二意见" advisor；一等公民的 MCP server 支持，stdio/http 懒连接，/mcp 命令管理。
native k3 video@earendil-works/pi-ai: kimi-k3 video_url wire support, video input through the read tool, and provider capability declarations — video understanding without an extension shim.kimi-k3 的 video_url 线格式、read 工具直接读视频、 provider 能力声明——不依赖扩展垫片的原生视频理解。
independent config home~/.musepi: Its own config directory, coexisting with a stock pi install. First run migrates auth, settings, models and keybindings from ~/.pi/agent; update checks run against MusePi’s own GitHub Releases (musepi.updateCheck, default on).独立配置目录，与原版 pi 共存。首次运行从 ~/.pi/agent 迁移 auth、settings、models、keybindings；更新检查走 MusePi 自己的 GitHub Releases（musepi.updateCheck，默认开）。
own update channel & What’s NewGitHub Releases · CHANGELOG.md: Updates come from MusePi’s own releases, and the startup What’s New screen is driven by MusePi’s own CHANGELOG.md — pre-fork upstream history is preserved as UPSTREAM-CHANGELOG.md.更新来自 MusePi 自己的 Release，启动 What's New 由 MusePi 自己的 CHANGELOG.md 驱动——fork 之前的上游历史完整保留在 UPSTREAM-CHANGELOG.md。
session & workflow extras/move · skills · snapcompact: /move relocates the session to another working directory; seven-scope skills discovery, snapcompact snapshot compaction, toolSelect dynamic tool gating, modelRoles per-role model routing, LSP integration and desktop notifications round out the daily loop./move 会话中切换工作目录；七级作用域 skills 发现、 snapcompact 快照压缩、toolSelect 动态工具加载、 modelRoles 分角色模型路由、LSP 集成与桌面通知，补齐日常闭环。
muselinn agent core@musepi/core · /transcript: Goal/plan orchestration, permission, hooks, skills, swarm and task logic as a host-independent package with zero host imports, plus a dedicated transcript layer.goal/plan 编排、permission、hooks、skills、swarm、task 逻辑封装为零宿主导入的独立包，另有专用 transcript 层。
muselinn rendererpackages/musepi/renderer: Replaces the upstream TUI rendering surface with damage-tracked containers — ~1 ms frame cost even at 2000 messages, verified in the render profile.用 damage-tracked 容器替换上游 TUI 渲染面—— 2000 条消息下每帧约 1 ms，渲染 profile 已验证。
upstream disciplinepin + monthly cherry-pick: Tracks earendil-works/pi with a pinned base and monthly cherry-picks of agent-loop fixes — no continuous rebase. The pinned commit, every cherry-pick and the conflict rules live in UPSTREAM.md.以 pin 基点 + 月度 cherry-pick 跟踪 earendil-works/pi，不做持续 rebase。基点 commit、每一次 cherry-pick 与冲突规则都记录在 UPSTREAM.md。

02Install & build安装与构建

One command installs the latest prebuilt binary for macOS (arm64/x64), Linux (x64/arm64) or Windows (x64/arm64) — six archives on the v0.1.1 release. The CLI identifies itself as MusePi; the executable is musepi. 一条命令安装最新预编译二进制，覆盖 macOS（arm64/x64）、 Linux（x64/arm64）、Windows（x64/arm64）——六个归档见 v0.1.1 release。 CLI 自报 MusePi，可执行文件名为 musepi。

One-line install一键安装

# macOS / Linux
curl -fsSL https://muselinn.github.io/MusePi/install | sh

# Windows (PowerShell)
irm https://muselinn.github.io/MusePi/install.ps1 | iex

musepi --version   # => MusePi 0.1.1

Installs to ~/.local/bin/musepi/ (%LOCALAPPDATA%\Programs\musepi on Windows) and adds it to your PATH. Config, sessions and auth live under ~/.musepi — a stock pi install is left untouched. Prefer a manual download? Grab an archive from GitHub Releases and keep the extracted directory intact.安装到 ~/.local/bin/musepi/ （Windows 为 %LOCALAPPDATA%\Programs\musepi）并写入 PATH。配置、会话与凭据都在 ~/.musepi 下—— 原版 pi 不受影响。想手动下载？从 GitHub Releases 取归档，保持解压目录结构完整即可。

From source (Node 24)源码构建（Node 24）

npm install --ignore-scripts
npm run build          # refresh models + build all
npm run check          # lint, format, types, lockfile
./test.sh              # tests (LLM tests self-skip)
./musepi-test.sh       # run MusePi from sources

Supply-chain policy: lifecycle scripts stay disabled; package-lock.json is the dependency ground truth.供应链策略：生命周期脚本一律禁用； package-lock.json 是依赖的唯一事实来源。

03New in 0.1.10.1.1 新功能

Released 2026-07-23. Full details in the changelog. 发布于 2026-07-23。完整内容见更新日志。

grouped settings panelsettings: The settings UI grows section headings and type-to-search, and a MusePi submenu exposes all 42 musepi.* options across nine groups — every knob the fork adds is finally visible in one place.设置界面引入分组标题与模糊搜索，MusePi 子菜单集中暴露全部 42 项 musepi.* 配置——fork 加过的每个开关终于一览无遗。
/memory commandmemory: view shows the exact injection payload the model sees, stats reports files and budgets, clear resets with confirmation, and enable/disable hot-switch the live session — the W5 memory system becomes fully discoverable.view 展示模型实际看到的注入内容，stats 报告文件与预算，clear 带确认重置，enable/disable 热切换当前会话——W5 记忆系统完全可见可控。
own What’s Newchangelog: The startup changelog is driven by MusePi’s own CHANGELOG.md — including the cross-distro fix so settings migrated from pi no longer hide it. Upstream history lives on as UPSTREAM-CHANGELOG.md.启动更新日志由 MusePi 自己的 CHANGELOG.md 驱动—— 含跨发行版修复：从 pi 迁移来的设置不再让它永久空白。上游历史保留为 UPSTREAM-CHANGELOG.md。

A fork of pi that grew into its own agent. 始于 pi 的 fork，长成自己的 agent。