Files
AgentHub/server/data/ai-tools/README.md
T
nntrivi2001 750d74a2af chore: v2.8.15 — Oh My Pi login sharing, omp --allow-home, Markdown Preview default, first-login password
- omp-share.js: an admin's switch (S3) runs omp's own auth broker + gateway as
  the host on loopback; a member's omp pane reaches it as a scoped client keyed
  by its pane token (clients file = live omp panes only), runs on
  --model agenthub/<model>, never holds a credential.
- omp catalog: --allow-home, so a workspace at the account's home keeps its
  sessions there (they were recorded under a temp dir and dropped).
- Settings → Appearance → Open Markdown as: Preview (default) or Raw, for
  Files/Changes, the config viewer and a chat's file panel.
- First-login password change and password rules, avatar URLs, Artifacts
  "Mine" includes installed shared skills/plugins, a member's own hook pages.
2026-10-22 10:04:30 +07:00

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, Grok and Cursor (--resume), OpenCode (--session). 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 _ (OpenCode's ses_…).

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>" } (runs npm install -g <package>@latest with the login shell's npm) or { "kind": "script", "url": "https://…" } (https, same site — last two host labels — as homepageUrl; downloaded by the server, run as bash <file>).
  • update: { "kind": "npm" } or { "kind": "script" } (reuse install), 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.