nntrivi2001
9c573f1e3c
Decisions, environment quirks and pitfalls learned while working on AgentHub (docs/claude-memory/, indexed by MEMORY.md). Notes holding personal account details are left out. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
27 lines
4.3 KiB
Markdown
27 lines
4.3 KiB
Markdown
- [AgentHub release state](agenthub-release-state.md) — 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](agenthub-plugin-update-chicken-egg.md) — installs ≤1.5.9 can never see a release; one manual command per machine.
|
||
- [Test env quirks](agenthub-flaky-codex-ingest-tests.md) — 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](agenthub-no-launchd-on-macos.md) — LaunchAgent built 09-25, untested on a real Mac; checklist in INSTALL.md § macOS
|
||
- [No agenthub agents/skills](no-agenthub-agents-skills.md) — never dispatch agenthub:* agents or skills; too quota-heavy
|
||
- [agy auto-updates on any run](agy-auto-updates-on-run.md) — spike run replaced ~/.local/bin/agy 1.0.0→1.2.13; warn first
|
||
- [Multi-user server goal](agenthub-multi-user-goal.md) — 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](agenthub-remote-clients-plan.md) — 10-09: users run AgentHub local, hub keeps accounts+records; account only via AgentHub; plan docs/plans/remote-clients
|
||
- [NEVER tmux kill-server](never-tmux-kill-server.md) — $TMUX beats TMUX_TMPDIR; it killed the real server + this session twice
|
||
- [Analytics parity plan](analytics-parity-plan.md) — phases 2–7 shipped in v2.4.0; ../agenthub-analytics now redundant; OpenAPI for new routes still missing
|
||
- [Dev/prod ports share one DB](agenthub-dev-prod-ports.md) — 4820 prod (systemd), 4830 user's dev in Warp; same dashboard.db, dev migrations hit prod
|
||
- [Workspace rename step 4](workspace-rename-step4.md) — remove `agenthub lanes`/`--lane` only ≥3 releases after aliases ship; never rename stored data
|
||
- [No git stash here](no-git-stash-shared-checkout.md) — parallel sessions share this checkout; use a worktree to test clean HEAD
|
||
- [Update never kills panes](update-never-kills-panes.md) — updates/restarts keep tmux lane panes; only Quit AgentHub (#65) closes them; KillMode=process
|
||
- [Claude Code changelog ≤2.1.295](claude-code-changelog-2-1-293.md) — 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](claude-haiku-5-5.md) — 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](remove-ineffective-skills.md) — delete skills with no effect or that lower quality; judge by usage/eval evidence
|
||
- [Link = learn & remember](link-means-learn-and-remember.md) — a bare docs/changelog URL means: extract what is useful for me, save to memory, no code changes
|
||
- [Claude Code @mention line range](claude-code-line-mention-syntax.md) — only `@path#L5-10` reads lines; `#5-10` attaches the whole file
|
||
- [Server box hardware](agenthub-server-box-hardware.md) — 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](s3-main-merge-notes.md) — tmux capturePane/sendKey → onServerOf, drop route via dropDir+member uid, one onServerOf only
|
||
- [/tmp wiped on reboot](tmp-wiped-on-reboot.md) — keep long-run scripts/renders in ~/.cache/<project>/ (tri-vi pipeline: ~/.cache/tri-vi-bake/)
|
||
- [OSC 7501 vs hooks](osc7501-vs-hooks.md) — tested: no replacement for hooks; needs a probe reply, never reaches through tmux; only a per-pane pty proxy would work
|
||
- [Fast bump/release](fast-bump-release.md) — release quickly: no full suites, --no-verify — but ALWAYS `tsc -b` (v2.7.0 broke every update)
|
||
- [Sandbox browser repro](agenthub-sandbox-browser-repro.md) — isolated server+build+playwright-core on :4899; no login, never the user's tmux
|
||
- [Instructions for other tools](instructions-other-tools.md) — only Claude/Codex take them; Cursor plugin-dir gated by server flag, agy global-only (tested 10-12)
|