@hlix/cli 1.2.0 → 1.3.1

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.
package/README.md CHANGED
@@ -12,11 +12,10 @@ verified review evidence from the terminal. Every call goes through
12
12
  [`@hlix/sdk`](https://www.npmjs.com/package/@hlix/sdk), which owns transport,
13
13
  auth, retry and error mapping.
14
14
 
15
- `hlix` on its own opens **Hlix Code**, the interactive terminal harness. It
16
- gives you a coding agent with every CLI command available as a slash command,
17
- and it chooses where that agent's files and shell live: your project's
18
- Cloud Machine when the folder is bound to hlix, and a local environment on this
19
- machine otherwise. `--sandbox cloud|docker|local` selects the environment;
15
+ `hlix` on its own opens **Hlix Code**. A folder bound to a project opens the
16
+ cloud client: the server owns conversations and work, and the terminal streams
17
+ their output. An unbound folder opens a local coding agent.
18
+ `--sandbox cloud|docker|local` selects the environment;
20
19
  `--sandbox docker` uses a Docker container, and `--local` is short for
21
20
  `--sandbox local`. The Docker container runs
22
21
  `node:22-bookworm` (git, node, python3 — no bun); `--docker-image <ref>`, or
@@ -55,8 +54,8 @@ For CI, and for anything else that must not change underneath you, pin the
55
54
  version instead of floating to `latest`:
56
55
 
57
56
  ```bash
58
- npm install --global @hlix/cli@1.2.0
59
- npx @hlix/cli@1.2.0 status --json
57
+ npm install --global @hlix/cli@1.3.1
58
+ npx @hlix/cli@1.3.1 status --json
60
59
  ```
61
60
 
62
61
  ## Authenticate
@@ -157,7 +156,25 @@ stored under `.hlix/tool-output/`. The Hlix agent inside a hosted Cloudflare box
157
156
  uses this local process path. The remote Cloud Machine CLI transport retains
158
157
  its own command limits.
159
158
 
160
- Inside the shell:
159
+ Inside a cloud project, type `/` to see commands and available project skills.
160
+ Click a cycle or use Ctrl-P to focus its conversation; Ctrl-N opens the harness
161
+ launcher. Messages appear immediately and follow-ups queue while a turn runs.
162
+ The header shows the actual server and connection state.
163
+
164
+ | Command | Action |
165
+ | --- | --- |
166
+ | `/project` | Switch projects without leaving the CLI |
167
+ | `/import [folder]` | Review and import the current files into a new cloud project, then switch to it; sibling worktrees stay local |
168
+ | `/cycles`, `/focus` | Select the conversation receiving your messages |
169
+ | `/launch <harness> <brief>` | Request work on a Cloud Machine with the chosen harness |
170
+ | `/skills` | Choose an available project skill |
171
+ | `/steer <message>`, `/force <message>` | Interrupt and send guidance next |
172
+ | `/interrupt` | Interrupt the project-manager turn while keeping queued messages; stop selected cycle work |
173
+ | `/stop` | Stop the selected session and cancel your queued project-manager messages |
174
+ | `/stop project` | Stop project work and cancel your queued project-manager messages |
175
+ | `/quit`, Ctrl-C | Disconnect; cloud work continues |
176
+
177
+ Inside a local or Docker agent session:
161
178
 
162
179
  | | |
163
180
  | ----------------------------------------- | ---------------------------------------------------------------------------------------- |