v0.9.15

DevEx overhaul. Four PRs landed simultaneously rebuilding the first-run experience to SkillKit-grade polish.

## Added

- **Splash banner + onboarding wizard** (#403). Terminal-width-aware ASCII (full at ≥120 cols, compact at 80–119, single-line below 80). First-run flow: multi-select 8 native-plugin agents + 8 MCP-server agents, single-select LLM provider (Anthropic / OpenAI / Gemini / OpenRouter / MiniMax / BM25-only), seeds `~/.agentmemory/.env` with the chosen provider's `*_API_KEY=` line commented.

- **`~/.agentmemory/preferences.json`** (#403). Schema-versioned JSON with smart defaults. Atomic write. Future runs skip the splash.

- **`agentmemory connect <agent>`** (#402). Automates native-plugin install for `claude-code`, `codex`, `cursor`, `gemini-cli`, `openclaw` end-to-end. Stubs for `hermes`, `pi`, `openhuman`. Each adapter: detect → backup → merge → verify → idempotent on re-run. Supports `--dry-run`, `--force`, `--all`, interactive picker.

- **`agentmemory remove`** (#406). Tears down everything we installed: pidfile, state, preferences, backups, `~/.local/bin/iii` (only when it matches our installed version), agent connections. Asks separately for `.env` and memory data dir. Two confirmations by default.

- **`agentmemory doctor` v2** (#406). Interactive Fix/Skip/More/Quit per finding. New flags: `--all` (auto-fix every finding, for CI), `--dry-run`.

- **`agentmemory stop --force`** (#405). Bypasses Docker-compose heuristic refusal so engines started before v0.9.14 can be torn down without `lsof | xargs kill`.

- **`--reset` flag**. Wipes preferences, re-runs onboarding.

- **`--verbose` / `AGENTMEMORY_VERBOSE=1`**. Restores the pre-v0.9.15 25-line `[agentmemory] X` engine-boot log stream when debugging.

## Changed

- **First-run output trimmed from 30+ lines to ~10**. The `[agentmemory] Worker v0.9.x` boot log stream is buffered behind a `bootLog` shim and only surfaces with `--verbose`.

- **`isEngineRunning()` short-circuit now adopts the engine** (#405). When the CLI finds an existing engine on `:3111`, it writes `~/.agentmemory/iii.pid` and `~/.agentmemory/engine-state.json` if neither exists. Closes the migration gap where pre-v0.9.14 engines could not be stopped via `agentmemory stop`.

- **Viewer port auto-bump** (#405). `:3113` taken → retry 3114 → 3115 → ... up to 3122 before failing loud. Pre-fix was silent skip.

- **Engine version-mismatch warning** (#405). iii on PATH != `IIPINNED_VERSION` (v0.11.2) now warns loud with override path. Pre-fix was silent acceptance — v0.11.6 on PATH led to undebuggable EPIPE loops.

- **npx PATH hint** (#405). Runs invoked via npx get one extra line after engine ready: `Tip: install globally for the bare \`agentmemory\` command: npm install -g @agentmemory/agentmemory`. Suppressible via `preferences.skipNpxHint`.

## Install

```bash
npx @agentmemory/agentmemory@0.9.15
# or
npm install -g @agentmemory/agentmemory@0.9.15
agentmemory
```

Full changelog: https://github.com/rohitg00/agentmemory/blob/main/CHANGELOG.md#0915--2026-05-15