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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +23 -12
  2. package/package.json +10 -10
package/README.md CHANGED
@@ -62,7 +62,9 @@ Native binaries ship for:
62
62
  | Build | `build` | Build the current project |
63
63
  | Build | `check` | Validate code and configuration |
64
64
  | Build | `preview` | Upload a built project as a draft |
65
- | Chat | `chat send <message>` | Start an interactive chat session |
65
+ | Chat | `chat` | Open or continue the primary interactive chat workflow |
66
+ | Chat | `chat interactive` | Explicit form of the interactive chat workflow |
67
+ | Chat | `chat send <message>` | Send a prompt and stay attached until stable |
66
68
  | Chat | `chat send --detach <message>` | Submit and return immediately |
67
69
  | Chat | `chat reply <message>` | Send a freeform clarification reply |
68
70
  | Chat | `chat active` | Discover likely active chat sessions |
@@ -85,7 +87,9 @@ Run `caffeine <command> --help` for the full flag list.
85
87
  ## Chat Workflow
86
88
 
87
89
  ```bash
88
- caffeine chat send "Build a weather dashboard"
90
+ caffeine chat
91
+ caffeine chat --project-id 11111111-1111-4111-8111-111111111111
92
+ caffeine chat interactive --project-id 11111111-1111-4111-8111-111111111111
89
93
  caffeine chat send --detach "Build a weather dashboard"
90
94
  caffeine chat active
91
95
  caffeine chat status
@@ -102,10 +106,21 @@ caffeine chat open
102
106
 
103
107
  All commands support `--json` for machine-readable output.
104
108
 
105
- `chat send` is interactive by default: it stays attached, streams progress and
106
- transcript updates, and exits when the session completes or needs
107
- clarification. Use `--detach` if you explicitly want a fire-and-check-later
108
- workflow.
109
+ `caffeine chat` is the primary human workflow. It resumes likely active chat
110
+ sessions for the target project, shows a recent transcript tail when nothing is
111
+ active, and lets you continue the conversation inline until you exit.
112
+
113
+ `chat interactive` is the explicit equivalent of bare `chat`.
114
+
115
+ Use the lower-level subcommands when you want a more scripted or detached flow:
116
+
117
+ - `chat send --detach` submits work and returns immediately
118
+ - `chat watch` and `chat resume` reattach to in-flight work
119
+ - `chat transcript`, `chat list`, `chat tail`, and `chat feed` expose the raw chat state
120
+ - `chat reply` and `chat submit-form` let you answer clarifications explicitly
121
+
122
+ Interactive chat does not support `--json`. Use the lower-level subcommands for
123
+ automation, CI, and machine-readable output.
109
124
 
110
125
  Clarification handling:
111
126
 
@@ -144,12 +159,8 @@ npx -y @caffeineai/mcp@dev --version
144
159
  The CLI and MCP server share the same auth, project, build, and chat contract.
145
160
  One login flow can cover both tools on the same machine.
146
161
 
147
- ## Notes
162
+ ## Links
148
163
 
149
- - `caffeine` with no subcommand opens the interactive terminal UI when run in
150
- an interactive terminal.
151
- - `caffeine chat open` hands the current project off to the browser chat UI.
152
- - `caffeine doctor --fix` installs missing local build prerequisites when
153
- possible.
164
+ Caffeine platform: https://caffeine.ai
154
165
 
155
166
  This package installs the matching platform binary through npm optional dependencies. Install the main package rather than a platform package directly.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@caffeineai/cli",
3
- "version": "0.1.0-dev.25",
3
+ "version": "0.1.0-dev.27",
4
4
  "description": "Caffeine CLI",
5
5
  "homepage": "https://caffeine.ai",
6
6
  "license": "SEE LICENSE IN LICENSE",
@@ -15,14 +15,14 @@
15
15
  "LICENSE"
16
16
  ],
17
17
  "optionalDependencies": {
18
- "@caffeineai/cli-darwin-arm64": "0.1.0-dev.25",
19
- "@caffeineai/cli-darwin-x64": "0.1.0-dev.25",
20
- "@caffeineai/cli-linux-arm64-glibc": "0.1.0-dev.25",
21
- "@caffeineai/cli-linux-x64-glibc": "0.1.0-dev.25",
22
- "@caffeineai/cli-linux-arm64-musl": "0.1.0-dev.25",
23
- "@caffeineai/cli-linux-x64-musl": "0.1.0-dev.25",
24
- "@caffeineai/cli-win32-arm64": "0.1.0-dev.25",
25
- "@caffeineai/cli-win32-x64": "0.1.0-dev.25"
18
+ "@caffeineai/cli-darwin-arm64": "0.1.0-dev.27",
19
+ "@caffeineai/cli-darwin-x64": "0.1.0-dev.27",
20
+ "@caffeineai/cli-linux-arm64-glibc": "0.1.0-dev.27",
21
+ "@caffeineai/cli-linux-x64-glibc": "0.1.0-dev.27",
22
+ "@caffeineai/cli-linux-arm64-musl": "0.1.0-dev.27",
23
+ "@caffeineai/cli-linux-x64-musl": "0.1.0-dev.27",
24
+ "@caffeineai/cli-win32-arm64": "0.1.0-dev.27",
25
+ "@caffeineai/cli-win32-x64": "0.1.0-dev.27"
26
26
  },
27
27
  "preferGlobal": true,
28
28
  "publishConfig": {
@@ -31,6 +31,6 @@
31
31
  "caffeine": {
32
32
  "distribution": "npmjs",
33
33
  "packageName": "@caffeineai/cli",
34
- "publishedAt": "2026-05-12T19:39:42.804Z"
34
+ "publishedAt": "2026-05-13T16:36:10.924Z"
35
35
  }
36
36
  }