e30fefab49
Docs and the command's own instructions previously implied /ccam-update fetches new code; it only reinstalled deps and restarted the server against whatever version was already resolved. It now also runs `claude plugin marketplace update` + `claude plugin update ccam@<mp> -y` first, and says plainly that /reload-plugins is still a manual step (no CLI/script equivalent exists to apply it automatically).
50 lines
2.0 KiB
Markdown
50 lines
2.0 KiB
Markdown
---
|
|
description: Pull the latest ccam plugin version and refresh the dashboard runtime
|
|
---
|
|
|
|
Pull the newest `ccam` release from its marketplace, then reinstall the runtime
|
|
dependencies and restart the dashboard server against it. Use this to get a new
|
|
dashboard build, or when `/ccam-doctor` reports missing dependencies or a dead
|
|
server.
|
|
|
|
First, find which marketplace this install's `ccam` came from and pull the
|
|
latest version into the plugin cache:
|
|
|
|
```bash
|
|
INSTALLED=$(claude plugin list 2>/dev/null | grep -o 'ccam@[^ ]*' | head -1)
|
|
MARKETPLACE="${INSTALLED#ccam@}"
|
|
if [ -z "$MARKETPLACE" ]; then
|
|
echo "ccam is not installed as a plugin (checkout install?) - nothing to update this way."
|
|
else
|
|
claude plugin marketplace update "$MARKETPLACE"
|
|
claude plugin update "ccam@$MARKETPLACE" -y
|
|
fi
|
|
```
|
|
|
|
That downloads the new version into `~/.claude/plugins/cache/` but does not
|
|
take effect in *this* session — Claude Code only re-resolves `${CLAUDE_PLUGIN_ROOT}`
|
|
on `/reload-plugins` (a REPL-only action, not scriptable from a command). Say
|
|
so plainly: **tell the user to run `/reload-plugins` now**, then either
|
|
re-run `/ccam-update` (this time the bootstrap step below runs against the new
|
|
version) or just start a new session — `plugin-bootstrap.js` compares the
|
|
recorded state against the current plugin version on every `SessionStart` and
|
|
rebuilds automatically if they differ.
|
|
|
|
Then, whether or not a plugin update was just pulled, refresh the runtime
|
|
against whatever `${CLAUDE_PLUGIN_ROOT}` currently resolves to. This stops the
|
|
running dashboard server before starting the new one. Say so, then run:
|
|
|
|
```bash
|
|
node "${CLAUDE_PLUGIN_ROOT}/scripts/plugin-bootstrap.js" --force
|
|
```
|
|
|
|
It runs in the foreground and can take a few minutes on a cold cache. When it
|
|
finishes, verify:
|
|
|
|
```bash
|
|
node "${CLAUDE_PLUGIN_ROOT}/scripts/plugin-doctor.js"
|
|
```
|
|
|
|
Report the final state in a few lines. If the bootstrap failed, quote the
|
|
decisive line from `~/.claude/agent-dashboard/runtime/bootstrap.log`.
|