Agent Gateway — AI skill for Claude Code

ag — Agent Gateway

[](https://github.com/yudch999-bot/agent-gateway/actions/workflows/test.yml) [](LICENSE) [](https://www.python.org/)

**One command to launch and switch between all your AI coding agents.**

Claude Code, Codex, Gemini, Grok, OpenCode, OpenClaw, Hermes, Pi, Goose, Kimi… Stop memorizing a dozen different launch commands and a dozen shell aliases. Put them all behind one fuzzy picker, and add your own by editing one line.

它管三层：

层	命令	解决什么
开哪个	ag / ag cc	十几套启动方式记不住
同时开几个	ag 里 Tab 多选 / ag team	一个不够用，还得手动开窗口
接着哪个干	ag last / ag resume / Ctrl-R	每次都要重新交代上下文
翻旧账 / 搬家	ag search / ag handoff	1.8G 会话历史躺着睡觉
顺带	ag outdated / ag update / ag stats / ag pin	批量运维、看习惯


ag            # 模糊选择器：打字即筛选，回车启动
ag cc         # 直接进 Claude Code
ag ot-design  # 直接进 OpenClaw 的 design 会话
ag cc --resume   # 参数原样透传

上面这段录像是**用真实的渲染器生成的**（不是手搓的假动画）， 所以画面和真跑逐字节一致 —— 见 [`docs/make-demo-cast.py`](docs/make-demo-cast.py)。

📖 想一次看全？**[完整使用指南 →](docs/使用指南.md)**（命令全表、选择器按键、 注册表字段、加自定义 agent、排障、FAQ）

---

装的东西太多，各有各的启动方式

本机装了 18 个 AI coding agent，启动方式全不一样：

• 有的命令名就是启动指令（codex、gemini、goose）
• 有的靠 shell 别名（cc→claude、oc→opencode、d→dsh-tui）
• 多会话的还得敲一长串（openclaw tui --session agent:design:main）
• 想加一个新的，就得改 .zshrc、重开 shell、再记住一个别名

`ag` 把这些收在一处：

原来的麻烦	现在
N 套启动方式要分别记	ag 一个命令，选就行
长命令记不住	ag ot-design
加新 agent 要动 .zshrc	ag add，存完立刻生效
装了但忘了叫什么	ag scan 扫出来
不知道哪个还能跑	ag doctor 体检

**原有的 shell 别名一个都不用删**，`ag` 是加在上面的一层。

---

安装

一条命令（会装到 `~/.local/bin/ag`，并在 `~/.zshrc` 追加一段 source）：

curl -fsSL https://raw.githubusercontent.com/yudch999-bot/agent-gatewa