@caffeineai/cli 0.1.0-dev.5 → 0.1.0-dev.51

package/README.md

@@ -1,23 +1,32 @@
 # @caffeineai/cli
 
-Command-line interface for the Caffeine platform.
+The public Caffeine command-line interface for authentication, project
+management, local development workflows, and headless AI chat.
 
 ## Development Release
 
-This is a DEV release. It is published under the npm `dev` dist-tag and is subject to a rapid release cadence. Expect frequent updates while the CLI and MCP packages settle.
+This is a DEV release. It is published under the npm `dev` dist-tag and is
+subject to a rapid release cadence. Expect frequent updates while the CLI
+package settles.
+
+## Features
+
+- Device and browser-based login
+- Project listing, inspection, creation, cloning, and deletion
+- Team workspace list, status, and switch (`X-Workspace-Id`)
+- Local install, build, check, preview, import, export, config, doctor, and update flows
+- Interactive and detached chat sessions over the Caffeine AI API
+- Browser chat hand-off when you want the web UI
 
 ## Installation
 
 ```bash
 npm install -g @caffeineai/cli@dev
+caffeine --version
 ```
 
 Three equivalent command names are installed: `caffeine`, `caf`, and `cfn`.
 
-```bash
-caffeine --version
-```
-
 ## Quick Start
 
 ```bash
@@ -43,24 +52,86 @@ Native binaries ship for:
 | Auth | `auth login [--device]` | Sign in via OAuth loopback or device flow |
 | Auth | `auth logout` | Sign out |
 | Auth | `auth status` | Show current session |
+| Workspaces | `workspaces list` | List personal account and team workspaces |
+| Workspaces | `workspaces status` | Show the selected workspace |
+| Workspaces | `workspaces use <id>` | Persist a team workspace, or `personal` |
 | Projects | `projects list` | List your projects |
 | Projects | `projects show <id>` | Show project details |
 | Projects | `projects create <name>` | Create a new project |
 | Projects | `projects clone <id> [--dest <path>] [--include-wip]` | Clone a project locally |
 | Projects | `projects delete <id>` | Delete a project |
-| Local | `import` | Import a project from a .zip |
-| Local | `export` | Export the current project to a .zip |
+| Local | `import <file>` | Import a project from a `.zip` |
+| Local | `export` | Export the current project to a `.zip` |
 | Build | `install` | Install build dependencies |
 | Build | `build` | Build the current project |
 | Build | `check` | Validate code and configuration |
 | Build | `preview` | Upload a built project as a draft |
-| Config | `config list` / `get <key>` / `set <key> <value>` | Manage CLI config |
+| Chat | `chat` | Open or continue the primary interactive chat workflow |
+| Chat | `chat interactive` | Explicit form of the interactive chat workflow |
+| Chat | `chat send <message>` | Send a prompt and stay attached until stable |
+| Chat | `chat send --detach <message>` | Submit and return immediately |
+| Chat | `chat reply <message>` | Send a freeform clarification reply |
+| Chat | `chat active` | Discover likely active chat sessions |
+| Chat | `chat status` | Show a high-level summary for an active session |
+| Chat | `chat watch` | Attach to a live session and stream updates |
+| Chat | `chat resume` | Reattach and wait for the next stable state |
+| Chat | `chat transcript` | Show the current transcript |
+| Chat | `chat feed` | Collect raw project feed events |
+| Chat | `chat list` | List chat messages |
+| Chat | `chat tail` | Poll chat messages until the AI reaches a stable state |
+| Chat | `chat submit-form` | Submit a structured clarification form reply |
+| Chat | `chat open` | Open the browser chat for a project |
+| Config | `config list` / `config get <key>` / `config set <key> <value>` | Manage CLI config |
 | Env | `doctor [--fix]` | Diagnose local build prerequisites |
 | Meta | `update` | Check for or install a newer CLI |
 | Meta | `version` | Show version info |
 
 Run `caffeine <command> --help` for the full flag list.
 
+## Chat Workflow
+
+```bash
+caffeine chat
+caffeine chat --project-id 11111111-1111-4111-8111-111111111111
+caffeine chat interactive --project-id 11111111-1111-4111-8111-111111111111
+caffeine chat send --detach "Build a weather dashboard"
+caffeine chat active
+caffeine chat status
+caffeine chat watch --project-id 11111111-1111-4111-8111-111111111111
+caffeine chat resume --project-id 11111111-1111-4111-8111-111111111111
+caffeine chat transcript --project-id 11111111-1111-4111-8111-111111111111
+caffeine chat feed --project-id 11111111-1111-4111-8111-111111111111 --timeout 5s
+caffeine chat submit-form \
+  --project-id 11111111-1111-4111-8111-111111111111 \
+  --message-index 42 \
+  --form-data '{"appName":"Habit Hero"}'
+caffeine chat open
+```
+
+All commands support `--json` for machine-readable output.
+
+`caffeine chat` is the primary human workflow. It resumes likely active chat
+sessions for the target project, shows a recent transcript tail when nothing is
+active, and lets you continue the conversation inline until you exit.
+
+`chat interactive` is the explicit equivalent of bare `chat`.
+
+Use the lower-level subcommands when you want a more scripted or detached flow:
+
+- `chat send --detach` submits work and returns immediately
+- `chat watch` and `chat resume` reattach to in-flight work
+- `chat transcript`, `chat list`, `chat tail`, and `chat feed` expose the raw chat state
+- `chat reply` and `chat submit-form` let you answer clarifications explicitly
+
+Interactive chat does not support `--json`. Use the lower-level subcommands for
+automation, CI, and machine-readable output.
+
+Clarification handling:
+
+- `ai_follow_up` means the AI wants more freeform input, so reply with `chat reply`
+- `system_dialog` with `info.form` means you should call `chat submit-form`
+- `ai_answer` means the exchange completed successfully
+
 ## JSON And Non-Interactive Mode
 
 Every command accepts `--json`. JSON output uses a stable envelope:
@@ -72,25 +143,32 @@ Every command accepts `--json`. JSON output uses a stable envelope:
 
 Use `--non-interactive` in scripts and CI.
 
+`--workspace <id>` and `--personal` are process-only account overrides. They
+do not rewrite `workspace.selectedId`. `caffeine workspaces use` persists the
+selection for later CLI and local MCP processes.
+
 ## Authentication
 
-`caffeine auth login` opens your browser for an OAuth flow. For CI or remote SSH, add `--device` to use the device flow instead.
+`caffeine auth login` opens your browser for an OAuth flow. For CI, remote
+SSH, or other headless environments, add `--device` to use the device flow
+instead.
 
-Tokens are stored in your OS credential store. The `@caffeineai/mcp` server reads the same credentials, so one login covers both packages.
+Tokens are stored in your OS credential store.
 
 ## MCP Server
 
-Drive Caffeine from Claude Code, Cursor, VS Code, Codex, Windsurf, or another MCP host with the companion MCP server:
+Drive Caffeine from Claude Code, Cursor, VS Code, Codex, Windsurf, or another
+MCP host with the companion MCP server:
 
 ```bash
 npx -y @caffeineai/mcp@dev --version
 ```
 
-See the `@caffeineai/mcp` README for host configuration.
+The CLI and MCP server share the same auth, workspace, project, build, and chat contract.
+One login flow can cover both tools on the same machine.
 
 ## Links
 
-- Source, issues, and release notes: https://github.com/caffeinelabs/caffeine-cli
-- Caffeine platform: https://caffeine.ai
+Caffeine platform: https://caffeine.ai
 
 This package installs the matching platform binary through npm optional dependencies. Install the main package rather than a platform package directly.

package/package.json

@@ -1,11 +1,8 @@
 {
   "name": "@caffeineai/cli",
-  "version": "0.1.0-dev.5",
+  "version": "0.1.0-dev.51",
   "description": "Caffeine CLI",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/caffeinelabs/caffeine-cli.git"
-  },
+  "homepage": "https://caffeine.ai",
   "license": "SEE LICENSE IN LICENSE",
   "bin": {
     "caffeine": "bin/caffeine.js",
@@ -18,21 +15,22 @@
     "LICENSE"
   ],
   "optionalDependencies": {
-    "@caffeineai/cli-darwin-arm64": "0.1.0-dev.5",
-    "@caffeineai/cli-darwin-x64": "0.1.0-dev.5",
-    "@caffeineai/cli-linux-arm64-glibc": "0.1.0-dev.5",
-    "@caffeineai/cli-linux-x64-glibc": "0.1.0-dev.5",
-    "@caffeineai/cli-linux-arm64-musl": "0.1.0-dev.5",
-    "@caffeineai/cli-linux-x64-musl": "0.1.0-dev.5",
-    "@caffeineai/cli-win32-arm64": "0.1.0-dev.5",
-    "@caffeineai/cli-win32-x64": "0.1.0-dev.5"
+    "@caffeineai/cli-darwin-arm64": "0.1.0-dev.51",
+    "@caffeineai/cli-darwin-x64": "0.1.0-dev.51",
+    "@caffeineai/cli-linux-arm64-glibc": "0.1.0-dev.51",
+    "@caffeineai/cli-linux-x64-glibc": "0.1.0-dev.51",
+    "@caffeineai/cli-linux-arm64-musl": "0.1.0-dev.51",
+    "@caffeineai/cli-linux-x64-musl": "0.1.0-dev.51",
+    "@caffeineai/cli-win32-arm64": "0.1.0-dev.51",
+    "@caffeineai/cli-win32-x64": "0.1.0-dev.51"
   },
+  "preferGlobal": true,
   "publishConfig": {
     "access": "public"
   },
   "caffeine": {
     "distribution": "npmjs",
     "packageName": "@caffeineai/cli",
-    "publishedAt": "2026-04-30T08:50:15.110Z"
+    "publishedAt": "2026-09-04T06:48:29.359Z"
   }
 }