figura-cli 0.19.0 → 0.21.0

package/README.md

@@ -18,11 +18,12 @@ npx figura-cli --help
 
 The binary is `figura`.
 
-Update later with one command — it bumps the CLI (and the bundled `figura mcp`
-server) to the latest and reinstalls the skills to match:
+Check what to run to update — it prints the one correct command for your package
+manager (npm / pnpm / yarn / bun) to bump the CLI and the bundled `figura mcp`
+server. It never self-executes an install:
 
 ```bash
-figura update            # detects bun vs npm; add --dry-run to preview
+figura upgrade           # prints e.g. `pnpm add -g figura-cli@latest`
 ```
 
 ## Authentication
@@ -81,6 +82,23 @@ Omitted fields keep their saved value — a name-only `brand set` won't wipe you
 tokens. Best of all, let Claude Code build the whole profile from your codebase —
 see the **figura-brand** skill below ("introduce my repo to Figura").
 
+## Claude Code integration — one command
+
+`figura install` sets up the **full** Claude Code integration in one shot — the
+skills, the update hook, and the status-bar badge:
+
+```bash
+figura install              # skills → ~/.claude/skills, hook + badge → global
+figura install --project    # skills → ./.claude/skills (this repo); hook + badge global
+figura install --uninstall  # reverse all three
+```
+
+It composes the three commands below, so it's idempotent — re-run it to repair a
+partial setup (e.g. you have the skill but no hook). `figura login --project` runs
+this same path, so a fresh `link` already wires up everything. The individual
+`figura skill install`, `figura hook install`, and `figura statusline install`
+commands still work on their own.
+
 ## Claude Code skills
 
 Install the bundled skills so Claude Code can work with Figura from any project:
@@ -137,20 +155,21 @@ and stale skills. Check anytime with:
 
 ```bash
 figura doctor          # installed vs latest; flags a behind CLI or drifted skills
-figura update          # update the CLI + reinstall the skills
+figura upgrade         # prints the manager-correct update command (never runs it)
 ```
 
-To automate it, install the Claude Code hook (`figura login --project` does this
-for you):
+To automate the check, install the Claude Code hook (`figura login --project`
+does this for you):
 
 ```bash
 figura hook install    # add a SessionStart check to ~/.claude/settings.json
 ```
 
-On each launch it checks — at most once a day, cached, and always in the
-background — whether anything is behind, reinstalls drifted skills in place, and
-kicks off `figura update` if the CLI is stale. It never blocks startup and stays
-silent when everything is current. Remove it with `figura hook install --uninstall`.
+On each launch it — at most once a day, cached — reinstalls drifted skills in
+place and, when the CLI is behind, prints a one-line notice to run
+`figura upgrade`. It never self-executes an install, never blocks startup, and
+stays silent when everything is current. Remove it with
+`figura hook install --uninstall`.
 
 ## Status-bar badge