Files
AgentHub/docs/plans/server-mode/CHECKLIST.md
T
nntrivi2001 a9c71cd905 feat: v2.5.12 — plan and quota for every AI tool, Grok Build and Kimi Code, Quit AgentHub (#65)
Usage panel (status bar):
- every account shows its plan (Claude subscriptionType, Codex
  chatgpt_plan_type, Cursor membershipType, Grok subscriptionTier)
- new quota rows: Cursor CLI (cursor.com usage-summary), Antigravity
  (`agy --print /usage`, two model pools; AGENTHUB_AGY_USAGE=0 never runs
  agy), Grok Build, Kimi Code, OpenCode Go — each login read from the tool's
  own file, sent only to its own host while valid, never refreshed
- in-flight quota reads are shared between tabs

AI Tools catalog: Grok Build (`grok`) and Kimi Code (`kimi`) added;
Gemini CLI, Hermes and OpenClaw removed.

Also: Quit AgentHub (#65, `agenthub stop`), status-area icon, Add to Chat
on an editor selection, Settings in three groups, JetBrains-style Changes
panel (ticked files/hunks, ignore, blame, file history), terminal font.

--no-verify: :3000 is taken by another dev server (lane-detect tests);
both suites run by hand — server 2636/2639 (the 3 are :3000), client
1131/1131.
2026-10-08 12:22:14 +07:00

5.1 KiB

Server mode — working checklist

Goal (2026-10-07): finish the server part — S2 ownership as proposed, review it.

  • S1 login, roles, agenthub server|users (uncommitted)
  • Claude account pool + balancer (uncommitted)
  • S2 core: lanes.owner_id, server/lib/scope.js (predicates, scopeGuard, broadcast audience, folder root), STAFF_ONLY_PREFIXES, pty attach check, heartbeat re-check
  • S2 routes: aggregates, rows, workflows (+ read worker), workspaces/runs — 4-agent workflow, each with its own test file
  • Bypass fix: apiPath() canonical path + case-insensitive rules (found by the workspaces agent)
  • S6 basics: GET /api/users, audit log (audit_log, agenthub users audit), Settings → Users, members' Settings hides staff pages
  • Adversarial review (5 lenses, 21 findings, each verified) and fixes: lane id coercion (1e1), PATCH run_id, array ids, POST agents/sessions, transcript path traversal (all modes), push per user, pool/quota leaks, pty re-check, CSRF origin on writes, parallel login throttle, overlapping folders, pane credential for CLI/MCP/statusline, lock namespace + lock-name path traversal (all modes), AuthGate retry/cache
  • Full suites: server 2532/2535 (3 lane-detect fail on a foreign process holding port 3000, same on clean HEAD), client 1074/1074; browser e2e member vs admin; docs synced
  • Upgrade-impact review (2026-10-07): old vs new API diff on a copy of the real DB (local mode identical but for noise), old+new builds sharing one migrated DB, 5-lens review + verify. Fixed: lock names (any single dir name ≤255, holders with spaces normalised, CLI fails fast on non-409), AuthGate rendering on an older server / DASHBOARD_TOKEN 401, pane_token_hash kept out of exports; documented the LAN origin change. Suites: server 2536/2536, client 1078/1078
  • Blocked on sudo / a real host: S0 spike, S3 (one Linux user per account), S4 (shared /opt tools)

2026-10-08 — per-user isolation (S3/S4 + per-user proxy/plugins + Codex pool)

Decided: own Linux user per account; skills/plugins = admin baseline + user's own; AI Proxy = user's own + admin's shared (no key shown); tool binaries shared under /opt/agenthub/tools; Claude pool shared (exists); NEW Codex multi-account pool. Spike allowed on this machine with sudo (undo log: /tmp/agh-spike/UNDO.sh).

  • S0 spike (2026-10-08, this machine; test users agh-test1/2 kept for S3 dev, undo /tmp/agh-spike/UNDO.sh) → results below
  • Per-user AI Proxy store (+ admin shared)
  • S3 provisioning + spawn/attach as the account
  • S4 shared tools in /opt
  • Per-user skills/plugins (cc-config per account HOME, admin baseline)
  • Codex account pool
  • Security review, docs, suites

S0 results (claude 2.1.293, codex 0.155.1, tmux 3.7c, node 26)

Check Result
Layout: /srv/agenthub/users 0751 root; home <acct>:agenthub 0750; member's own group private GO — a member cannot list or read another home or the host's
claude / codex / node run from root-owned /opt/agenthub/tools/bin with a foreign HOME GO — nothing written outside the home; a root-owned binary cannot self-update (plus DISABLE_AUTOUPDATER=1)
Per-account tmux server, socket in a setgid agenthub dir, server-access -a <host> + chmod 0770 GO — host send-keys/capture/attach work, the pane runs as the member; tmux keeps group rw across attach; another member is refused
Hooks as the member: node /opt/.../hook-handler.js → CLAUDE_DASHBOARD_PORT on loopback GO — SessionStart/UserPromptSubmit arrive with the member's transcript_path
Codex rollouts readable by the dashboard via group GO — 0644 under 0775
Claude transcripts readable by the dashboard via group NO — .jsonl created 0600, sessions/ 0700; a default ACL is masked to ---. Needs a decision
agy not run (it self-updates on any run); root-owned /opt stops that
Host group membership needs a new login: a running systemd --user keeps its old groups → server mode wants a system unit with SupplementaryGroups=agenthub
Shared Claude pool token across Linux users setup-token is long-lived, no refresh rotation → safe
Codex pool with ChatGPT logins untested (no spare account): refresh tokens rotate, so a copied auth.json must be copied back under a lock; API-key accounts have no such risk

Open decision: how the dashboard reads every tool's files (user, 2026-10-08: "all AI tools, lightest")

Proposal: server mode runs as a system unit with AmbientCapabilities=CAP_DAC_READ_SEARCH (read any file, no write; zero per-read cost, no per-tool code) fenced by InaccessiblePaths= (/etc/shadow, /etc/gshadow, /etc/sudoers*, /root, /home) and NoNewPrivileges. Every WRITE in a member's folder (git-ops, file editor, worktrees, tmux spawn) runs as the member via sudo -u <acct> (sudoers: host may run commands as %agenthub-members only, never root). Git reads need -c safe.directory=* (dubious-ownership check). Verification command not yet run (blocked by the agent's permission classifier — user to run it). Code work waits until the in-flight Quit/tray/Users change-set is committed, then a new branch.