@caffeineai/cli 0.1.0-dev.23 → 0.1.0-dev.25

package/README.md

@@ -1,23 +1,31 @@
 # @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
+- 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
@@ -48,19 +56,63 @@ Native binaries ship for:
 | 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 send <message>` | Start an interactive chat session |
+| 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 send "Build a weather dashboard"
+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.
+
+`chat send` is interactive by default: it stays attached, streams progress and
+transcript updates, and exits when the session completes or needs
+clarification. Use `--detach` if you explicitly want a fire-and-check-later
+workflow.
+
+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:
@@ -74,22 +126,30 @@ Use `--non-interactive` in scripts and CI.
 
 ## 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, project, build, and chat contract.
+One login flow can cover both tools on the same machine.
 
-## Links
+## Notes
 
-- Caffeine platform: https://caffeine.ai
+- `caffeine` with no subcommand opens the interactive terminal UI when run in
+  an interactive terminal.
+- `caffeine chat open` hands the current project off to the browser chat UI.
+- `caffeine doctor --fix` installs missing local build prerequisites when
+  possible.
 
 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,6 +1,6 @@
 {
   "name": "@caffeineai/cli",
-  "version": "0.1.0-dev.23",
+  "version": "0.1.0-dev.25",
   "description": "Caffeine CLI",
   "homepage": "https://caffeine.ai",
   "license": "SEE LICENSE IN LICENSE",
@@ -15,14 +15,14 @@
     "LICENSE"
   ],
   "optionalDependencies": {
-    "@caffeineai/cli-darwin-arm64": "0.1.0-dev.23",
-    "@caffeineai/cli-darwin-x64": "0.1.0-dev.23",
-    "@caffeineai/cli-linux-arm64-glibc": "0.1.0-dev.23",
-    "@caffeineai/cli-linux-x64-glibc": "0.1.0-dev.23",
-    "@caffeineai/cli-linux-arm64-musl": "0.1.0-dev.23",
-    "@caffeineai/cli-linux-x64-musl": "0.1.0-dev.23",
-    "@caffeineai/cli-win32-arm64": "0.1.0-dev.23",
-    "@caffeineai/cli-win32-x64": "0.1.0-dev.23"
+    "@caffeineai/cli-darwin-arm64": "0.1.0-dev.25",
+    "@caffeineai/cli-darwin-x64": "0.1.0-dev.25",
+    "@caffeineai/cli-linux-arm64-glibc": "0.1.0-dev.25",
+    "@caffeineai/cli-linux-x64-glibc": "0.1.0-dev.25",
+    "@caffeineai/cli-linux-arm64-musl": "0.1.0-dev.25",
+    "@caffeineai/cli-linux-x64-musl": "0.1.0-dev.25",
+    "@caffeineai/cli-win32-arm64": "0.1.0-dev.25",
+    "@caffeineai/cli-win32-x64": "0.1.0-dev.25"
   },
   "preferGlobal": true,
   "publishConfig": {
@@ -31,6 +31,6 @@
   "caffeine": {
     "distribution": "npmjs",
     "packageName": "@caffeineai/cli",
-    "publishedAt": "2026-05-11T22:56:21.469Z"
+    "publishedAt": "2026-05-12T19:39:42.804Z"
   }
 }