@dosu/cli 0.66.1 → 0.67.0-beta.10

package/README.md

@@ -105,7 +105,7 @@ Or right-click the binary, select "Open", and click "Open" in the dialog.
 
 `dosu mcp add` takes `-g, --global` to install for all projects instead of project-local, and `--show-secret` to print the full manual config.
 
-`dosu upgrade` delegates to npm, pnpm, Yarn Classic, or Homebrew only after confirming which manager owns the current installation. Temporary package-runner invocations stay ephemeral, ambiguous or local installs are left unchanged, and standalone binaries receive the latest safe manual download path. After a successful update it hands off to the new version, which re-applies the bundled skills and, only if the update crossed a release that changed the agent config format, runs `dosu setup` (or the non-interactive `dosu mcp refresh` without a TTY). Upgrades done outside `dosu upgrade` (npm, brew, `npx @dosu/cli@latest`) get a safety net: when the new version changed the shape of the MCP entry, the first command on it silently rewrites configured tools' MCP entries and prompts you to run `dosu setup` for the rest; the bundled agent skills are always re-applied on the first command after any version change.
+`dosu upgrade` delegates to npm, pnpm, Yarn Classic, or Homebrew only after confirming which manager owns the current installation. Temporary package-runner invocations stay ephemeral, ambiguous or local installs are left unchanged, and standalone binaries receive the latest safe manual download path. After a successful update it hands off to the new version, which re-applies the bundled skills and, only when a configured agent's MCP entry is out of date, runs `dosu setup` (or the non-interactive `dosu mcp refresh` without a TTY). An entry is out of date when it doesn't match the shape the current provider code writes. Upgrades done outside `dosu upgrade` (npm, brew, `npx @dosu/cli@latest`) get a safety net: on the first command of a new version, the CLI checks each configured provider, silently rewrites only the out-of-date entries, and prompts you to run `dosu setup` for the rest; the bundled agent skills are always re-applied on the first command after any version change.
 
 Dosu also updates itself automatically. When the update check (every six hours) finds a newer release, npm, pnpm, Yarn Classic, and Homebrew installs start the same package-manager update in a detached background process. The current command runs unchanged, and your next command uses the new version, whose first run applies the skill and MCP refreshes above. Hooks, rules, and the status line still need `dosu setup` when a release changes them. Background updates never run for `npx` invocations, standalone binaries, CI, or `DOSU_DEV=true`. A failed install (for example, a global npm prefix that needs `sudo`) falls back to the "Run `dosu upgrade`" notice and is retried after six hours. Turn background updates off with `dosu upgrade --auto off` (and back on with `--auto on`), or with `DOSU_DISABLE_AUTOUPDATE=1` for a single environment.
 
@@ -119,7 +119,7 @@ Once authenticated against a deployment, you can drive the Dosu platform without
 | `dosu knowledge` | Search and browse your knowledge base |
 | `dosu docs` | Manage documents (list, create, update, import, publish) |
 | `dosu threads` | List and manage conversation threads |
-| `dosu review` | Document review workflow, plus `review notifications` to route a Library's or Agent's reviews to a Slack channel |
+| `dosu review` | Document review workflow for the selected Library, plus `review notifications` to route a Library's or Agent's reviews to a Slack channel |
 | `dosu sources` | Manage connected data sources (list, connect, create, sync, update) |
 | `dosu integrations` | List and inspect platform integrations (Slack, GitHub, …) |
 | `dosu topics` | List knowledge base topics and their pages |
@@ -133,33 +133,28 @@ Run `dosu <command> --help` for subcommands and flags.
 
 ### Agent skills
 
-The `dosu` skill — which teaches coding agents how to operate Dosu through this CLI — lives in [`skills/dosu`](skills/dosu) and is embedded in the CLI at build time, so the copy an agent reads always matches the installed CLI version. `dosu setup` (and `dosu skill install`) writes it to `~/.agents/skills/dosu`, the universal location read by Cursor, Codex, Gemini CLI, Zed, Cline, Copilot, OpenCode, and Antigravity, and symlinks Claude Code's `~/.claude/skills/dosu` and Windsurf's `~/.codeium/windsurf/skills/dosu` at that copy. After a CLI upgrade, the first command re-applies the skill automatically; `dosu skill update` does the same on demand. The former standalone [`dosu-ai/dosu-skill`](https://github.com/dosu-ai/dosu-skill) repository is deprecated in favour of this bundle.
+The `dosu` skill — which teaches coding agents how to operate Dosu through this CLI — lives in [`skills/dosu`](skills/dosu) and is embedded in the CLI at build time, so the copy an agent reads always matches the installed CLI version. `dosu setup` (and `dosu skill install`) writes it to `~/.agents/skills/dosu`, the universal location read by Cursor, Codex, Gemini CLI, Copilot, and OpenCode, and symlinks Claude Code's `~/.claude/skills/dosu` at that copy. After a CLI upgrade, the first command re-applies the skill automatically; `dosu skill update` does the same on demand. The former standalone [`dosu-ai/dosu-skill`](https://github.com/dosu-ai/dosu-skill) repository is deprecated in favour of this bundle.
 
 To change a skill, edit `skills/<name>/…` and run `bun run embed:skills` to regenerate `src/generated/skills.ts` (a test fails if the two drift).
 
 ### Supported AI tools
 
-`dosu mcp add <id>` and the setup wizard support:
+`dosu mcp add <id>` and the setup wizard support the coding agents whose sessions Dosu can learn from — each one keeps a session log on disk that [`@letta-ai/trajectory`](https://github.com/letta-ai/trajectory) normalizes:
 
 | ID | Tool |
 |---|---|
 | `claude` | Claude Code |
-| `claude-desktop` | Claude Desktop |
 | `cursor` | Cursor |
-| `vscode` | VS Code |
 | `codex` | Codex CLI |
 | `gemini` | Gemini CLI |
-| `windsurf` | Windsurf |
-| `zed` | Zed |
-| `cline` | Cline |
-| `cline-cli` | Cline CLI |
 | `copilot` | GitHub Copilot CLI |
 | `opencode` | OpenCode |
-| `antigravity` | Antigravity |
-| `mcporter` | MCPorter |
-| `factory` | Factory |
+| `factory` | Factory (droid) |
+| `pi` | Pi (installs the Dosu pi extension; global only) |
 | `manual` | Manual Configuration (prints config to paste yourself) |
 
+Tools with no such log (Claude Desktop, VS Code, Windsurf, Zed, Cline, Antigravity, MCPorter, ...) can still reach Dosu's MCP server: `dosu mcp add manual` prints the entry to paste into their config. The CLI no longer writes it for them, since nothing it does for them beyond that entry could learn from their sessions.
+
 ### Non-interactive / agent setup
 
 For coding agents and CI, `setup` has a non-interactive mode:
@@ -185,15 +180,21 @@ dosu knowledge incognito status                            # which agents are in
 The status line shows one of `📚 Dosu studying…` (a sync run is live), `📚 Dosu on`,
 `👻 Dosu incognito`, `⚪ Dosu paused`, `⚪ Dosu not studying this repo`, or `⚪ Dosu off`. Every
 session is studied unless you limit studying to picked repos under `dosu` → settings → study
-scope. Notes from a session with a known repo and branch are anchored to that branch; the rest are
-unanchored and reach topics immediately. Neither setup nor `enable` replaces a status line you
+scope. In an interactive terminal with more than one repo, `dosu setup` asks which repos' sessions
+to ship before offering the backfill of recent sessions. Selecting every repo clears the scope, so
+new repos are included automatically. The choice is saved as the study scope; change it later under
+`dosu` → settings → study scope or with `dosu knowledge scope set`. Notes from a session with a
+known repo and branch are anchored to that branch; the rest are unanchored and reach topics
+immediately. Neither setup nor `enable` replaces a status line you
 already have; they print the one-liner to add to your own script instead.
 
 `incognito on` is a saved per-agent setting: none of that agent's sessions are studied until you
-turn it off. To keep a single chat out instead, type `/dosu-incognito` in it; setup installs that
-command with the hook. It marks the session's transcript so studying skips it (the whole session,
-and for the rest of it — start a new session to turn Dosu back on) and tells the model not to use
-Dosu tools. See [docs/studying.md](docs/studying.md).
+turn it off. Turning it off resumes studying only new sessions going forward; sessions that
+finished while incognito was on stay unstudied permanently, even if a later sync picks them up.
+To keep a single chat out instead, type `/dosu-incognito` in it; setup installs that command with
+the hook. It marks the session's transcript so studying skips it (the whole session, and for the
+rest of it — start a new session to turn Dosu back on) and tells the model not to use Dosu
+tools. See [docs/studying.md](docs/studying.md).
 
 ### Telemetry and privacy