@anythingai/cli 0.0.2 → 0.0.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anythingai/cli",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "homepage": "https://anything.com/",
   "license": "MIT",
   "bin": {
@@ -18,6 +18,9 @@
     "registry": "https://registry.npmjs.org"
   },
   "scripts": {
+    "gen": "npx @hey-api/openapi-ts",
+    "gen:spec": "tsx scripts/generate-spec.mts",
+    "check:spec": "tsx scripts/check-spec.mts",
     "build": "tsdown --no-dts --out-dir dist/js",
     "prepublishOnly": "yarn build",
     "test:unit": "jest --config=jest.unit.config.ts --passWithNoTests",
@@ -38,6 +41,7 @@
     "@createinc/env": "^0.0.0",
     "@createinc/flux-api": "0.0.0",
     "@createinc/tsconfig": "0.0.0",
+    "@hey-api/openapi-ts": "^0.88.0",
     "@jest/environment": "^30.2.0",
     "@swc/core": "^1.9.3",
     "@swc/jest": "^0.2.37",
@@ -51,6 +55,7 @@
     "reflect-metadata": "^0.2.2",
     "testcontainers": "^10.18.0",
     "tsdown": "^0.20.3",
+    "tsx": "^4.21.0",
     "typescript": "^5.9.3"
   },
   "engines": {

package/skills/anything-cli/SKILL.md

@@ -56,13 +56,36 @@ anything projects get <project-id> --json
 anything projects publish <project-id> --json          # waits for deploy
 ```
 
+## Async Generation (recommended for agents)
+
+The default `--wait` mode uses WebSocket subscriptions which can be unreliable. Use `--no-wait` and poll `projects status` for a robust HTTP-only alternative:
+
+```bash
+# Start generation (returns immediately)
+REVISION=$(anything projects generate <id> --prompt "..." --no-wait --quiet)
+
+# Poll until terminal state (VALID or INVALID)
+while true; do
+  STATUS=$(anything projects status <id> --json | jq -r '.data.status')
+  case "$STATUS" in
+    VALID) echo "Done"; break ;;
+    INVALID) echo "Failed"; break ;;
+    INVALID_PROMPT) echo "Bad prompt"; break ;;
+    *) sleep 5 ;;
+  esac
+done
+```
+
+Terminal statuses: `VALID` (success), `INVALID` (generation failed), `INVALID_PROMPT` (bad prompt).
+Non-terminal: `CREATED`, `BUILDING`.
+
 ## One-Shot Workflow
 
 ```bash
 anything ship --prompt "Build a todo app with auth" --json
 ```
 
-The `ship` command creates (or generates on existing), then publishes and waits for the deployment to finish. It streams progress as NDJSON in `--json` mode, or `[init]`/`[progress]`/`[done]` markers in text mode. Use `--no-wait` for fire-and-forget workflows.
+The `ship` command creates (or generates on existing), then publishes and waits for the deployment to finish. It streams progress as NDJSON in `--json` mode, or `[init]`/`[progress]`/`[done]` markers in text mode. `--no-wait` only skips waiting for the deployment to finish — generation still blocks via WebSocket. If you want fully HTTP-only async behavior, use the two-step `projects generate --no-wait` + `projects publish` pattern above instead.
 
 ```bash
 anything ship --project pg_123 --prompt "Add a settings page" --json
@@ -93,6 +116,8 @@ anything switch                                    # interactive org/project pic
 anything llm-context --json                        # combined agent context
 anything introspect                                # full command tree as JSON
 anything skill                                     # print SKILL.md
+anything update --check --json                     # is a newer CLI version available?
+anything update --json                             # self-update to the latest version
 ```
 
 ### Project creation and iteration
@@ -101,7 +126,7 @@ anything skill                                     # print SKILL.md
 anything projects create --org <org-id> --prompt "<prompt>" --json
 anything projects generate <project-id> --prompt "<prompt>" --json
 anything projects messages <project-id> --limit 20 --json
-anything projects get <project-id> --json
+anything projects get <project-id> --json    # `data.files[]` lists modules with `path`/`pathSegment`
 anything projects files list <project-id> --json
 anything projects files get <project-id> app/page.tsx --json
 anything projects rename <project-id> --name "New Name" --json