@blinkdotnew/cli 0.1.9 → 0.2.0

package/README.md

@@ -1,6 +1,6 @@
 # @blinkdotnew/cli
 
-The Blink platform CLI. Deploy apps, query databases, generate AI content, manage storage — all from your terminal or agent scripts.
+The Blink platform CLI. Deploy apps, query databases, generate AI content, manage storage, and control Blink Claw agents — all from your terminal or agent scripts.
 
 ```bash
 npm install -g @blinkdotnew/cli
@@ -15,20 +15,27 @@ blink --help
 # Install
 npm install -g @blinkdotnew/cli
 
-# Authenticate (enter your blnk_ak_... API key)
+# Authenticate (enter your blnk_ak_... API key from blink.new → Settings → API Keys)
 blink login --interactive
 
-# Link a project
-blink link
+# See full context: agent + project + auth
+blink status
 
-# Deploy a built app
-blink deploy ./dist --prod
+# Manage Claw agents
+blink agent list
+eval $(blink agent use clw_xxx --export)
+blink secrets set GITHUB_TOKEN ghp_xxx
+blink secrets list
+
+# Deploy an app
+npm run build && blink deploy ./dist --prod
 
 # Query your database
 blink db query "SELECT count(*) FROM users"
 
-# Generate an image
+# Generate AI content
 blink ai image "a glowing blink logo on dark background"
+blink ai text "Summarize this article: ..."
 ```
 
 ---
@@ -338,8 +345,8 @@ blink storage upload ./banner.png --json | jq -r '.url'
 The CLI is **pre-installed** in every Blink Claw agent (Fly.io Firecracker VM). These env vars are already injected — no login needed:
 
 ```
-BLINK_API_KEY    auth token
-BLINK_AGENT_ID   per-agent billing identity
+BLINK_API_KEY    auth token (workspace-scoped)
+BLINK_AGENT_ID   this agent's ID — auto-used by blink agent/secrets commands
 BLINK_APIS_URL   https://core.blink.new
 BLINK_APP_URL    https://blink.new
 ```
@@ -351,6 +358,48 @@ Agents use the CLI directly in skill scripts:
 blink ai image "$PROMPT" --model "$MODEL" --json
 ```
 
+### `blink agent` — Manage agents
+
+```bash
+blink agent list                           # List all agents in workspace
+blink agent use clw_xxx                    # Show how to set active agent
+eval $(blink agent use clw_xxx --export)   # Set active agent for this session
+blink agent status                         # Show current agent details
+blink agent status clw_xxx                 # Show specific agent details
+```
+
+On Claw machines, `BLINK_AGENT_ID` is already set — `blink agent status` works with zero config.
+
+### `blink secrets` — Agent encrypted vault
+
+```bash
+# All commands auto-use BLINK_AGENT_ID on Claw machines
+blink secrets list                         # List secret key names (values never shown)
+blink secrets set GITHUB_TOKEN ghp_xxx     # Add or update a secret
+blink secrets delete OLD_KEY               # Remove a secret (--yes to skip prompt)
+
+# Cross-agent management (agent manager pattern)
+blink secrets list --agent clw_other       # Another agent's keys
+blink secrets set --agent clw_other OPENAI_KEY sk-xxx   # Set on another agent
+```
+
+Secrets are stored encrypted and available as `$KEY_NAME` in all agent shell commands.
+
+Agent ID resolution for `blink agent` and `blink secrets`:
+1. `--agent <id>` flag
+2. `BLINK_AGENT_ID` env var ← always set on Claw Fly machines
+3. `BLINK_ACTIVE_AGENT` env var ← from `eval $(blink agent use clw_xxx --export)`
+
+### `blink status` — Full context at a glance
+
+```bash
+$ BLINK_AGENT_ID=clw_xxx blink status
+
+Agent    clw_xxx           (BLINK_AGENT_ID env)
+Project  proj_yyy          (.blink/project.json)
+Auth     ~/.config/blink/config.toml
+```
+
 ---
 
 ## Links

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blinkdotnew/cli",
-  "version": "0.1.9",
+  "version": "0.2.0",
   "description": "Blink platform CLI — deploy apps, manage databases, generate AI content",
   "bin": {
     "blink": "dist/cli.js"