Home / maplezzk / pi-extensions · packages/pi-interactive-subagents/SKILL.md · GitHub

configure-pi-interactive-subagents skillA

configure-pi-interactive-subagents is agent-read markdown (skill) from maplezzk/pi-extensions: 配置与排查 interactive subagents 的终端复用器、Herdr split/tab 和状态面板。Use when configuring subagent mux behavior..

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.

What the file says

# 配置 pi-interactive-subagents

## 诊断

读取实际 Pi agent 目录下的 `extensions/pi-interactive-subagents/config.json`:`mux` 保存后端偏好,`herdrMode` 保存 `split|tab`,`allowSubagentSpawning` 控制子 agent 是否可以创建/管理其他 subagent,`subagentExtensions` 指定子 agent 显式加载的扩展路径列表,默认不自动发现其他扩展。默认 `allowSubagentSpawning` 为 `false`,`subagent-done.ts` 始终加载。状态面板的 `status.enabled` 由安装包根目录的 `config.json` 读取;不存在时读取同目录 `config.json.example`。状态行数当前固定为 4,不是配置项。面板只列未被隐藏的子 agent:`pi-dynamic-workflows` 通过 `__pi_subagents` 启动的 `agent()` 带 `hiddenFromWidget: true`,只出现在 Workflow 面板。面板里看不到某个 workflow 子 agent 属于预期行为,不是漏记;对应 pane、监听和中断仍然正常。

环境变量优先级:`PI_TERMINAL_MUX` > `PI_SUBAGENT_MUX` > 持久化 `mux` > `auto`;`PI_SUBAGENT_HERDR_MODE` > 持久化 `herdrMode` > `split`。

`/config:subagent extensions` 或 `/config:subagent-extensions` 可直接配置 `subagentExtensions`:命令会发现项目级和全局扩展并提供候选列表,`subagent-done.ts` 始终加载且不能移除;已卸载的扩展会被检测并跳过。也可以手动输入路径,命令参数用逗号分隔,输入 `clear` 清空可选扩展。

## 修改

优先运行:

```text
/config:subagent auto|muxy|cmux|tmux|zellij|wezterm|herdr [split|tab]|otty|orca
```

不带参数时使用交互选择。`/subagent-config`、`/pi-subagent-config` 是兼容别名。选择会立即写入用户配置并应用;环境变量仍可覆盖。

不要把未支持的后端写入配置。修改状态配置时只使用 `status.enabled`;`status.lineLimit` 等未知字段会显式失败,无效 JSON 也不会静默回退。

## 验证
…

Read the whole file at its exact version.

How to install

Latest version
mdr add maplezzk/pi-extensions/configure-pi-interactive-subagents@git:20260918.137b800
Exact content
mdr add maplezzk/pi-extensions/configure-pi-interactive-subagents@sha256:5e744f0038ef9125

Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_bi7wfpuwu3ikndl2.svg)](https://markdownregistry.com/a/art_bi7wfpuwu3ikndl2)

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260918.137b800 latest2026-09-18 137b800 2,458 BA view · diff
git:20260908.1742b642026-09-08 1742b64 2,166 BA view · diff
git:20260908.52905ae2026-09-08 52905ae 2,006 BA view · diff
git:20260904.7a514342026-09-04 7a51434 1,811 BA view · diff
git:20260820.57a98632026-08-20 57a9863 1,540 BA view

Audit of the latest version

A  17 of 17 checks passed. Deterministic, no model, same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (2458 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

maplezzk/pi-extensions · 12 stars · license MIT · pushed 2026-09-22 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_bi7wfpuwu3ikndl2
GET https://markdownregistry.com/api/v1/resolve?ref=maplezzk/pi-extensions/configure-pi-interactive-subagents
GET https://markdownregistry.com/api/v1/blob/5e744f0038ef91257315c97b392c723e53c445c34a4ae47c6bcbf2d9ee43009c

Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

More from maplezzk/pi-extensions

AGENTS.md agents
maplezzk/pi-extensions · AGENTS.md
git:20260922.961f354 · audit A · 12 stars
configure-pi-auto-goal skill
maplezzk/pi-extensions · packages/pi-auto-goal/SKILL.md · 配置与排查 pi-auto-goal 的提前停止判定、判定模型、干预上限与催促文案。Use when configuring or diagnosing premature-stop judgement.
git:20260922.a62090b · audit A · 12 stars
configure-pi-clean-mode skill
maplezzk/pi-extensions · packages/pi-clean-mode/SKILL.md · 配置与排查 pi-clean-mode 的配置面板、折叠单位、耗时头、自动展开与快捷键。Use when configuring clean mode, opening its settings panel, or diagnosing…
git:20260922.73feb1a · audit A · 12 stars
configure-pi-distill skill
maplezzk/pi-extensions · packages/pi-distill/SKILL.md · 配置与排查 pi-distill 的模型、压缩阈值、重试、工具开关和审计卡片。Use when configuring pi-distill or diagnosing output distillation.
git:20260820.57a9863 · audit A · 12 stars
configure-pi-dynamic-workflows skill
maplezzk/pi-extensions · packages/pi-dynamic-workflows/SKILL.md · 配置与排查 pi-dynamic-workflows 的执行后端和异步模式。Use when configuring workflow backend, async mode, or subagent integration.
git:20260820.57a9863 · audit A · 12 stars
configure-pi-extensions-i18n skill
maplezzk/pi-extensions · packages/pi-extensions-i18n/SKILL.md · 配置 Pi 扩展共享语言并排查 locale 优先级、持久化设置和 catalog。Use when changing zh-CN/en-US/auto language behavior.
git:20260919.b3f1f59 · audit A · 12 stars
configure-pi-extensions-tool-display skill
maplezzk/pi-extensions · packages/pi-extensions-tool-display/SKILL.md · 配置与排查 Pi 工具展示宿主、内建/自定义工具 override、输出模式和 diff 视图。Use when changing pi-extensions-tool-display rendering.
git:20260820.57a9863 · audit A · 12 stars
configure-pi-metrics skill
maplezzk/pi-extensions · packages/pi-metrics/SKILL.md · 启用与排查 pi-metrics 的耗时、TPS、TTFT、token 和成本遥测。Use when configuring or diagnosing Pi session metrics.
git:20260920.81cdf04 · audit A · 12 stars
configure-pi-models-discovery skill
maplezzk/pi-extensions · packages/pi-models-discovery/SKILL.md · 配置与排查 models.json 的动态模型发现、缓存刷新、鉴权和离线回退。Use when adding discoverModels providers or refreshing model catalogs.
git:20260920.5241ae4 · audit A · 12 stars
configure-pi-naming skill
maplezzk/pi-extensions · packages/pi-naming/SKILL.md · 配置 Pi 统一 /rename、首条消息命名和终端目标归属。Use when configuring pi-naming.
git:20260914.d76b5b5 · audit A · 12 stars
configure-pi-nested-skills skill
maplezzk/pi-extensions · packages/pi-nested-skills/SKILL.md · 配置与排查 pi-nested-skills 的技能根目录、递归发现、别名调用和补全。Use when configuring nested skill roots, aliases, discovery, or completion.
git:20260907.3bd68af · audit A · 12 stars
configure-pi-notifications skill
maplezzk/pi-extensions · packages/pi-notifications/SKILL.md · 配置与排查 pi-notifications 的外部通知命令、argv 参数、超时和一次性失败提示。Use when configuring or diagnosing Pi external notifications.
git:20260907.3bd68af · audit A · 12 stars

Every file in maplezzk/pi-extensions

Browse by kind, by grade A, or by owner.