agent-shell

把当前 zsh / bash / fish 变成 Agent 终端：默认输入就是跟 AI 对话，普通命令照旧原样执行（agent 进入 / agent off 退出）

以 Pi package（技能形态）发布。技能本体在 skills/agent-shell/。

• 平台：全平台
• 许可：GPL-3.0-or-later（全文见 LICENSE）

安装

pi install git:gitea.vhkd.top/pi-hub/agent-shell.git@v0.1.0

装完 pi-skill list 能看到 agent-shell，pi-skill agent-shell check 会告诉还缺什么。

先准备什么

• 用系统已有的东西即可，没有额外依赖。

常用命令

命令	说明
doctor	自检：每个后端（pi/codex/exec）在不在、当前用哪个、python3 与 zsh/bash/fish 三层各自是否可用与已装载、状态目录、会话与存活 tab
list	列出可续会话（序号 / 名字 / 上下文用量 / 条数 / 最后目录）
status	当前 tab 的会话详情（名字 / 模型 / 上下文 / 花费 / 文件）
new	新建会话（上下文清空，目录不变）
use	切换本 tab 的会话（序号 / 短码或其唯一前缀 / 名字）
name	给当前会话改名（名字显示在 agent list 里）
enter	进入 agent 模式（正常由终端里的 agent 命令调用）
off	退出 agent 模式（会话保留在盘上）
delete	删除会话（默认只预览，--yes 生效）
config	本工具自己的设置（后端/模型/推理级别/超时/通知/OSC133/外观）：show / set <键> <值>… / reset [--yes] / edit / path / shell
install	把 source 行装进启动文件（zsh: ~/.zshrc；bash: ~/.bashrc + 需要时的登录 profile；fish: conf.d/agent-shell.fish）；--shell zsh
uninstall	从启动文件移除（三种 shell 都清，默认只预览，--yes 生效）

用法与对外契约见技能内的 SKILL.md 与 REFERENCE.md。