configure-pi-interactive-subagents SKILL.md skillA

configure-pi-interactive-subagents from maplezzk/pi-extensions is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add maplezzk/pi-extensions/configure-pi-interactive-subagents@git:20260918.137b800

Pins git:20260918.137b800 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
maplezzk/pi-extensions
Path
packages/pi-interactive-subagents/SKILL.md
Versions recorded
5
Latest version
git:20260918.137b800, committed Sep 18, 2026
First version recorded
Aug 20, 2026
Size
2,458 bytes
Repository stars
20
License
MIT

配置与排查 interactive subagents 的终端复用器、Herdr split/tab 和状态面板。Use when configuring subagent mux behavior.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file 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

The exact contents, by fingerprint
mdr add maplezzk/pi-extensions/configure-pi-interactive-subagents@sha256:5e744f0038ef9125

The line at the top of this page pins the label git:20260918.137b800, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

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

5 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 5 versions of this file, between Aug 20, 2026 and Sep 18, 2026, about one every 7 days.

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. Fixed automatic checks with no AI involved, so the same checks give the 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 · 20 stars · license MIT · pushed 2026-11-06 · 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 AI assistant 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.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from maplezzk/pi-extensions

AGENTS.md AGENTS.md file
maplezzk/pi-extensions · AGENTS.md
git:20260922.1612473 · audit A · 20 stars
configure-pi-auto-goal SKILL.md 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 · 20 stars
configure-pi-clean-mode SKILL.md 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:20261006.3c36c0d · audit A · 20 stars
configure-pi-distill SKILL.md skill
maplezzk/pi-extensions · packages/pi-distill/SKILL.md · 配置与排查 pi-distill 的模型、压缩阈值、重试、工具开关和审计卡片。Use when configuring pi-distill or diagnosing output distillation.
git:20261007.3cd5266 · audit A · 20 stars
configure-pi-dynamic-workflows SKILL.md skill
maplezzk/pi-extensions · packages/pi-dynamic-workflows/SKILL.md · 配置与排查 pi-dynamic-workflows 的执行后端和异步模式。Use when configuring workflow backend, async mode, or subagent integration.
git:20260922.07de307 · audit A · 20 stars
configure-pi-extensions-i18n SKILL.md skill
maplezzk/pi-extensions · packages/pi-extensions-i18n/SKILL.md · 配置 Pi 扩展共享语言并排查 locale 优先级、持久化设置和 catalog。Use when changing zh-CN/en-US/auto language behavior.
git:20260922.c7d696c · audit A · 20 stars
configure-pi-extensions-tool-display SKILL.md 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 · 20 stars
configure-pi-gen-ui SKILL.md skill
maplezzk/pi-extensions · packages/pi-gen-ui/SKILL.md · 配置与排查 pi-gen-ui 的面板渲染、交互面板、结果行数上限与 Jev 组合。Use when configuring json-render panels or diagnosing render_ui/compose_ui.
git:20261005.f7aef84 · audit A · 20 stars
configure-pi-metrics SKILL.md skill
maplezzk/pi-extensions · packages/pi-metrics/SKILL.md · 启用与排查 pi-metrics 的耗时、TPS、TTFT、token 和成本遥测。Use when configuring or diagnosing Pi session metrics.
git:20260922.07de307 · audit A · 20 stars
configure-pi-models-discovery SKILL.md skill
maplezzk/pi-extensions · packages/pi-models-discovery/SKILL.md · 配置与排查 models.json 的动态模型发现、缓存刷新、鉴权和离线回退。Use when adding discoverModels providers or refreshing model catalogs.
git:20261106.4058f39 · audit A · 20 stars
configure-pi-naming SKILL.md skill
maplezzk/pi-extensions · packages/pi-naming/SKILL.md · 配置 Pi 统一 /rename、首条消息命名和终端目标归属。Use when configuring pi-naming.
git:20261017.d758347 · audit A · 20 stars
configure-pi-nested-skills SKILL.md skill
maplezzk/pi-extensions · packages/pi-nested-skills/SKILL.md · 配置与排查 pi-nested-skills 的技能根目录、递归发现、别名调用和补全。Use when configuring nested skill roots, aliases, discovery, or completion.
git:20260922.e07845b · audit A · 20 stars

Every file in maplezzk/pi-extensions

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