@blinkdotnew/cli 0.1.8 → 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/dist/cli.js

@@ -1203,7 +1203,8 @@ After creating a project, link it to your current directory:
   });
   project.command("delete <project_id>").description("Delete a project").option("--yes", "Skip confirmation").action(async (projectId, opts) => {
     requireToken();
-    if (!opts.yes) {
+    const skipConfirm = opts.yes || process.argv.includes("--yes") || process.argv.includes("-y");
+    if (!skipConfirm && process.stdout.isTTY) {
       const { confirm } = await import("@clack/prompts");
       const ok = await confirm({ message: `Delete project ${projectId}? This cannot be undone.` });
       if (!ok) {
@@ -1475,7 +1476,8 @@ Examples:
 `).action(async (key, opts) => {
     requireToken();
     const agentId = requireAgentId(opts.agent);
-    if (!opts.yes && !isJsonMode()) {
+    const skipConfirm = opts.yes || process.argv.includes("--yes") || process.argv.includes("-y");
+    if (!skipConfirm && !isJsonMode() && process.stdout.isTTY) {
       const { confirm } = await import("@clack/prompts");
       const ok = await confirm({ message: `Delete secret "${key}" from agent ${agentId}?` });
       if (!ok) {

package/package.json

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

package/src/commands/project.ts

@@ -49,7 +49,8 @@ After creating a project, link it to your current directory:
     .option('--yes', 'Skip confirmation')
     .action(async (projectId: string, opts) => {
       requireToken()
-      if (!opts.yes) {
+      const skipConfirm = opts.yes || process.argv.includes('--yes') || process.argv.includes('-y')
+      if (!skipConfirm && process.stdout.isTTY) {
         const { confirm } = await import('@clack/prompts')
         const ok = await confirm({ message: `Delete project ${projectId}? This cannot be undone.` })
         if (!ok) { console.log('Cancelled.'); return }

package/src/commands/secrets.ts

@@ -96,7 +96,8 @@ Examples:
     .action(async (key: string, opts) => {
       requireToken()
       const agentId = requireAgentId(opts.agent)
-      if (!opts.yes && !isJsonMode()) {
+      const skipConfirm = opts.yes || process.argv.includes('--yes') || process.argv.includes('-y')
+      if (!skipConfirm && !isJsonMode() && process.stdout.isTTY) {
         const { confirm } = await import('@clack/prompts')
         const ok = await confirm({ message: `Delete secret "${key}" from agent ${agentId}?` })
         if (!ok) { console.log('Cancelled.'); return }