- opencode.json / grok.json leave the built-in catalog; opencode-usage.js, its poller, transcript branch and table creation go with it (existing tables and session rows stay as history). - A Grok payload reaching the Claude hook route (Grok runs the Claude hooks itself) is dropped instead of recorded as tool = 'grok'. - quota.js no longer reads Grok or OpenCode Go logins. - Redone on v2.8.22 from c6b2892 (feat/grok-usage, never merged).
2.3 KiB
AI Tools catalog
One JSON file per AI coding CLI AgentHub can run in a lane. Loaded by
server/lib/ai-tools.js; the fields are described in
docs/superpowers/specs/2026-09-28-ai-tools-a1-design.md § 1. A file in
DASHBOARD_AI_TOOLS_DIR with the same id replaces the built-in one (it may
not set launcher).
Resume by id
resumeById (string array, e.g. ["--resume"]): the flag(s) a NAMED session's
id follows, as one more argv element — pty-run.js emits them in place of
resume when a start carries resumeSessionId, and only for an id that starts
with a letter or digit. A tool without it (and without a launcher) refuses a
resume by id (EUNSUPPORTED) rather than start fresh under a "resume".
Built-in: omp and Cursor (--resume). omp always gets --allow-home: started in its account's home (a workspace there) it would otherwise move to a temp dir, and its session would name that folder, not the workspace's. A session id may carry _.
Install / update (A2)
Two optional fields, honoured only in built-in files and in the copy of the
newest release's catalog that server/lib/ai-tools-sync.js keeps in
<data dir>/runtime/ai-tools-remote/ — a file in DASHBOARD_AI_TOOLS_DIR
carrying either is rejected, because an Install click would run what it names:
install:{ "kind": "npm", "package": "<npm name>" }(runsnpm install -g <package>@latestwith the login shell's npm) or{ "kind": "script", "url": "https://…" }(https, same site — last two host labels — ashomepageUrl; downloaded by the server, run asbash <file>).update:{ "kind": "npm" }or{ "kind": "script" }(reuseinstall), or{ "kind": "self", "args": ["update"] }(the tool's own updater).
Before adding an npm package, check its owner (npm view <pkg> maintainers repository.url) and that its bin matches detect: a squatted name would
install a stranger's code on every machine that clicks Install.
Attribution
The commands, prompt modes, permission-bypass flags and homepages of the tools
other than Claude Code, Codex and Antigravity come from Orca
(https://github.com/stablyai/orca, MIT License, Copyright (c) Stably AI):
src/renderer/src/lib/agent-catalog.tsx, src/shared/tui-agent-config.ts and
src/shared/tui-agent-permissions.ts.