AgentHub/docs/claude-memory/MEMORY.md

• AgentHub release state — v2.7.4 released 10-12 (b3fe10a4, release 571); v2.7.3 = 5d8fc9bb/570; v2.7.2 = 3a8be55b/569; v2.7.1 = 2fd0c903/568; v2.7.0 = f6f1bf4a/567; v2.6.2 = f0dc1445/566; notes EN then VI, never mention server mode or roles
• Plugin update chicken-and-egg — installs ≤1.5.9 can never see a release; one manual command per machine.
• Test env quirks — NODE_ENV=test for client/commit; npm install needs NODE_ENV=development --include=dev (else dev deps pruned); rtk hides output; kill orphan vitest workers after a hung run; test servers need env -u TMUX; pre-commit in a linked worktree sets core.bare=true; pane env AGENTHUB_MODE + AGENTHUB_USERS_ROOT break server tests (env -u ALL AGENTHUB_* vars)
• macOS auto-start — LaunchAgent built 09-25, untested on a real Mac; checklist in INSTALL.md § macOS
• No agenthub agents/skills — never dispatch agenthub:* agents or skills; too quota-heavy
• agy auto-updates on any run — spike run replaced ~/.local/bin/agy 1.0.0→1.2.13; warn first
• Multi-user server goal — server MODE, no fork, released v2.6.0; prod :4820 = system unit on worktree server-s3 (moved to v2.7.1 on 10-12); plan in docs/plans/server-mode/
• Remote clients plan — 10-09: users run AgentHub local, hub keeps accounts+records; account only via AgentHub; plan docs/plans/remote-clients
• NEVER tmux kill-server — $TMUX beats TMUX_TMPDIR; it killed the real server + this session twice
• Analytics parity plan — phases 2–7 shipped in v2.4.0; ../agenthub-analytics now redundant; OpenAPI for new routes still missing
• Dev/prod ports share one DB — 4820 prod (systemd), 4830 user's dev in Warp; same dashboard.db, dev migrations hit prod
• Workspace rename step 4 — remove agenthub lanes/--lane only ≥3 releases after aliases ship; never rename stored data
• No git stash here — parallel sessions share this checkout; use a worktree to test clean HEAD
• Update never kills panes — updates/restarts keep tmux lane panes; only Quit AgentHub (#65) closes them; KillMode=process
• Claude Code changelog ≤2.1.295 — 2.1.285–295 (to 10-08): hooks onFailure:block (keep AgentHub fail-open), OSC 7501 tested (no use), Workflow scriptPath rules
• Claude Haiku 5.5 — 10-07 release, $0.10/$0.50 split at 100k prompt; AgentHub models it as long_* subset columns (not a PK dim)
• Remove ineffective skills — delete skills with no effect or that lower quality; judge by usage/eval evidence
• Link = learn & remember — a bare docs/changelog URL means: extract what is useful for me, save to memory, no code changes
• Claude Code @mention line range — only @path#L5-10 reads lines; #5-10 attaches the whole file
• Server box hardware — 4c/15GB, HDD bind mounts caused lag; AgentHub ok to ~100 hooks/s+10 viewers; reinstall all-SSD, HDD for backups
• S3→main merge notes — tmux capturePane/sendKey → onServerOf, drop route via dropDir+member uid, one onServerOf only
• /tmp wiped on reboot — keep long-run scripts/renders in ~/.cache// (tri-vi pipeline: ~/.cache/tri-vi-bake/)
• OSC 7501 vs hooks — tested: no replacement for hooks; needs a probe reply, never reaches through tmux; only a per-pane pty proxy would work
• Fast bump/release — release quickly: no full suites, --no-verify — but ALWAYS tsc -b (v2.7.0 broke every update)
• Sandbox browser repro — isolated server+build+playwright-core on :4899; no login, never the user's tmux
• Instructions for other tools — only Claude/Codex take them; Cursor plugin-dir gated by server flag, agy global-only (tested 10-12)