@dosu/cli 0.20.0 → 0.20.2

package/README.md

@@ -1,5 +1,22 @@
 # dosu-cli
 
+> Connect [Dosu](https://dosu.dev) to your AI coding tools. `dosu` authenticates you, picks a Dosu deployment, and wires the Dosu MCP server into Claude Code, Cursor, Codex, and more — plus commands to drive the Dosu platform from your terminal.
+
+[![npm version](https://img.shields.io/npm/v/@dosu/cli.svg)](https://www.npmjs.com/package/@dosu/cli)
+[![CI](https://github.com/dosu-ai/dosu-cli/actions/workflows/ci.yml/badge.svg)](https://github.com/dosu-ai/dosu-cli/actions/workflows/ci.yml)
+[![codecov](https://codecov.io/gh/dosu-ai/dosu-cli/branch/main/graph/badge.svg)](https://codecov.io/gh/dosu-ai/dosu-cli)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](#license)
+
+## Quick Start
+
+```bash
+npx @dosu/cli setup
+```
+
+The interactive wizard authenticates you via browser OAuth, lets you pick a Dosu deployment (or OSS / public-library mode), mints an API key, detects which AI tools you have installed, and writes the Dosu MCP server entry into each one's config. Restart your AI tool and Dosu is available.
+
+Run `dosu` with no arguments any time to open the interactive menu.
+
 ## Installation
 
 ### npx / npm (Recommended)
@@ -65,30 +82,117 @@ Or right-click the binary, select "Open", and click "Open" in the dialog.
 
 **Note:** Installing via Homebrew avoids this issue automatically.
 
-## Releasing (for maintainers)
+## Usage
+
+### Core commands
+
+| Command | Description |
+|---|---|
+| `dosu` | Launch the interactive TUI menu |
+| `dosu setup` | Run the setup wizard (auth → deployment → detect tools → configure) |
+| `dosu login` | Authenticate with Dosu via browser OAuth |
+| `dosu logout` | Clear saved credentials |
+| `dosu status` | Show current authentication and MCP status |
+| `dosu mcp list` | List supported AI tools |
+| `dosu mcp add <tool>` | Add the Dosu MCP server to a specific tool |
+| `dosu logs` | View or manage debug logs (`--tail`, `--clear`) |
+
+`dosu mcp add` takes `-g, --global` to install for all projects instead of project-local, and `--show-secret` to print the full manual config.
+
+### Platform commands
+
+Once authenticated against a deployment, you can drive the Dosu platform without leaving the terminal:
+
+| Command | Description |
+|---|---|
+| `dosu ask` | Ask a question and get an AI-generated answer |
+| `dosu knowledge` | Search and browse your knowledge base |
+| `dosu docs` | Manage documents (list, create, update, import, publish, AI-generate) |
+| `dosu suggest` | Review and accept AI document suggestions |
+| `dosu threads` | List and manage conversation threads |
+| `dosu review` | Document review workflow |
+| `dosu sources` | Manage connected data sources (list, sync, update) |
+| `dosu integrations` | List and inspect platform integrations (Slack, GitHub, …) |
+| `dosu tags` | Manage knowledge base tags |
+| `dosu members` | Manage team members and access requests |
+| `dosu org` | Show organization information |
+| `dosu deployments` | List / show / switch deployments |
+| `dosu analytics` | View usage statistics |
+| `dosu insights` | Open a visual report of your Dosu space activity |
+| `dosu skill` | Install / update / remove the Dosu agent skill |
+| `dosu hooks` | Install / remove / diagnose Dosu coding-agent hooks |
+
+Run `dosu <command> --help` for subcommands and flags.
+
+### Supported AI tools
+
+`dosu mcp add <id>` and the setup wizard support:
+
+| 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 |
+| `manual` | Manual Configuration (prints config to paste yourself) |
+
+### Non-interactive / agent setup
+
+For coding agents and CI, `setup` has a non-interactive mode:
 
-Releases are automated via `bun build --compile` and GitHub Actions.
+```bash
+dosu setup --agent --tool claude
+```
 
-### Creating a Release
+Combine with `dosu login --request` / `--check <ticket>` for human-in-the-loop authentication, and `--mode oss|cloud` to skip the mode prompt.
+
+## Configuration
+
+Credentials and the selected deployment live in `~/.config/dosu-cli/config.json`. Set `DOSU_DEV=true` to isolate config under `~/.config/dosu-cli-dev/`.
+
+To repoint a published build at a different backend without rebuilding, set any of these runtime overrides:
+
+- `DOSU_WEB_APP_URL_OVERRIDE`
+- `DOSU_BACKEND_URL_OVERRIDE`
+- `SUPABASE_URL_OVERRIDE`
+- `SUPABASE_ANON_KEY_OVERRIDE`
+
+## Development
+
+```bash
+bun install        # install dependencies
+bun run dev        # run the CLI from source
+bun run test       # run tests (vitest)
+bun run check      # lint + format check (Biome)
+bun run typecheck  # tsc --noEmit
+```
+
+See [AGENTS.md](AGENTS.md) for architecture and contributor notes.
+
+## Releasing (for maintainers)
 
-1. **Ensure all changes are committed and pushed to `main`**
+Releases are fully automated with [semantic-release](https://github.com/semantic-release/semantic-release) — there are no manual version tags. Every push to a release branch is analyzed for [Conventional Commit](https://www.conventionalcommits.org/) messages, which determine the version bump.
 
-2. **Create and push a new tag:**
-   ```bash
-   git tag v0.2.0
-   git push origin v0.2.0
-   ```
+| Branch | npm dist-tag | Version shape |
+|---|---|---|
+| `main` | `latest` | `0.20.1` |
+| `alpha` | `alpha` | `0.20.1-alpha.1` |
 
-3. **GitHub Actions will automatically:**
-   - Run tests
-   - Build binaries for all platforms (macOS, Linux, Windows)
-   - Create a GitHub release with the binaries
-   - Publish to npm (`@dosu/cli`)
-   - Update the Homebrew formula
+On a qualifying push, the CI pipeline bumps the version, builds binaries for all platforms, creates a GitHub release with the archives, publishes to npm, and (for stable releases only) updates the Homebrew formula.
 
-### Version Naming
+Commit messages that don't follow Conventional Commits are invisible to semantic-release and won't trigger a release. See [AGENTS.md](AGENTS.md) for the full type → release-impact table and the alpha channel workflow.
 
-- Production releases: `v1.0.0`, `v1.1.0`, `v2.0.0`
-- Pre-releases: `v0.1.0-alpha`, `v0.1.0-beta`, `v0.1.0-rc1`
+## License
 
-Pre-release tags (containing `-alpha`, `-beta`, `-rc`) are automatically marked as pre-releases on GitHub and published to npm under the `next` dist-tag.
+MIT — see the `license` field in [package.json](package.json).

package/bin/dosu.js

@@ -4548,7 +4548,7 @@ var init_dist4 = __esm(() => {
 function getVersionString() {
   return `v${VERSION}`;
 }
-var VERSION = "0.20.0";
+var VERSION = "0.20.2";
 
 // src/debug/logger.ts
 import {
@@ -10992,8 +10992,22 @@ async function startOAuthFlow(signal, path2 = "/cli/auth", params = {}) {
     const authURL = buildAuthURL(callbackURL, path2, params);
     logger.info("auth.flow", `Auth URL: ${authURL}`);
     const open2 = await Promise.resolve().then(() => (init_open(), exports_open));
-    await open2.default(authURL);
-    logger.info("auth.flow", "Browser open command executed");
+    let browserOpened = false;
+    try {
+      await open2.default(authURL);
+      browserOpened = true;
+      logger.info("auth.flow", "Browser open command executed");
+    } catch (openErr) {
+      logger.warn("auth.flow", `Could not open browser automatically: ${openErr instanceof Error ? openErr.message : String(openErr)}`);
+    }
+    if (!browserOpened) {
+      console.log(`
+Could not open a browser automatically.`);
+      console.log(`Please open this URL in your browser to log in:
+`);
+      console.log(`  ${authURL}
+`);
+    }
     const timeout = new Promise((_3, reject) => {
       timeoutId = setTimeout(() => {
         logger.warn("auth.flow", "Authentication timed out (8min)");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dosu/cli",
-  "version": "0.20.0",
+  "version": "0.20.2",
   "type": "module",
   "description": "Dosu CLI - Manage MCP servers for AI tools",
   "license": "MIT",
@@ -35,25 +35,23 @@
     "node": ">=18"
   },
   "devDependencies": {
-    "@biomejs/biome": "^2.4.9",
+    "@biomejs/biome": "^2.5.0",
+    "@clack/prompts": "^0.10.1",
+    "@dosu/api-types": "0.0.7",
     "@semantic-release/changelog": "^6.0.3",
     "@semantic-release/exec": "^7.1.0",
     "@semantic-release/git": "^10.0.1",
     "@trpc/client": "11.8.0",
     "@trpc/server": "11.8.0",
-    "@types/bun": "^1.3.11",
-    "@vitest/coverage-v8": "^3.2.0",
-    "semantic-release": "^25.0.3",
-    "typescript": "^5.8.3",
-    "vitest": "^3.1.1"
-  },
-  "dependencies": {
-    "@clack/prompts": "^0.10.0",
-    "@dosu/api-types": "0.0.7",
+    "@types/bun": "^1.3.14",
+    "@vitest/coverage-v8": "^4.1.9",
     "commander": "^13.1.0",
-    "open": "^10.1.0",
+    "open": "^10.2.0",
     "picocolors": "^1.1.1",
+    "semantic-release": "^25.0.5",
     "superjson": "^2.2.6",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.9",
     "write-file-atomic": "^5.0.1"
   }
 }