怎么装
Pi
pi install git:gitea.vhkd.top/pi-hub/agent-shell@v0.1.0装完跑 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|bash|fish|all 限定，默认只预览，--yes 生效 |
uninstall | 从启动文件移除（三种 shell 都清，默认只预览，--yes 生效） |