@plusonelabs/cue 0.0.93 → 0.0.95

package/dist/skills/image/SKILL.md

@@ -0,0 +1,169 @@
+---
+name: image
+description: Generate images via `cue image`. Create app icons, illustrations, and artwork using AI image generation with customizable aspect ratios and resolutions.
+category: media
+type: context
+metadata:
+  short-description: Generate images from text prompts
+  scope: first-party
+---
+
+Generate images from text prompts using the Cue CLI.
+
+## Requirements
+
+- `cue` CLI installed and authenticated (`cue` then `/auth`)
+
+## Usage
+
+### Generate an image
+
+```bash
+cue image "prompt"
+```
+
+Images are saved to `~/.cue/images/` by default with auto-generated filenames.
+
+### Save to specific path
+
+```bash
+cue image "prompt" -o /path/to/output.png
+cue image "prompt" --output /path/to/output.png
+```
+
+### Set aspect ratio
+
+```bash
+cue image "prompt" --aspect-ratio 1:1      # Square (app icons)
+cue image "prompt" --aspect-ratio 16:9     # Landscape (wallpapers)
+cue image "prompt" --aspect-ratio 9:16     # Portrait (phone wallpapers)
+cue image "prompt" -a 1:1                  # Short form
+```
+
+**Available aspect ratios:**
+
+- `1:1`, `square` - Square (1024x1024)
+- `16:9`, `landscape` - Widescreen landscape
+- `9:16`, `portrait` - Phone portrait
+- `4:3`, `3:4`, `3:2`, `2:3`, `4:5`, `5:4`, `21:9`
+
+### Use a specific model
+
+```bash
+cue image "prompt" --model gemini-3.1-flash-image-preview  # Default, fast
+cue image "prompt" --model gemini-3-pro-image-preview  # Higher quality, 4K support
+```
+
+### High resolution (4K)
+
+Only available with `gemini-3-pro-image-preview`:
+
+```bash
+cue image "prompt" --model gemini-3-pro-image-preview --resolution 4K
+```
+
+**Available resolutions:** `1K`, `2K`, `4K`
+
+### Use a specific account
+
+```bash
+cue auth list                                    # List accounts
+cue --profile cue:team image "prompt" -o icon.png
+```
+
+## Examples
+
+### App icon
+
+```bash
+cue image "a sudoku puzzle game icon, blue and white grid, minimal flat design" \
+  -o /tmp/sudoku-icon.png --aspect-ratio 1:1
+```
+
+### Cocktail recipe app icon
+
+```bash
+cue image "a cocktail recipe app icon, colorful martini glass with citrus garnish, minimal flat design" \
+  -o /tmp/cocktail-icon.png -a 1:1
+```
+
+### Illustration for a post
+
+```bash
+cue image "cozy coffee shop interior, warm lighting, watercolor style illustration" \
+  -o /tmp/coffee-shop.png
+
+# Then upload and create post
+cue media upload /tmp/coffee-shop.png
+# Returns: {"media_id":"abc-123",...}
+
+cue post '{"content":[{"type":"post","title":"Coffee Shop Vibes","media":[{"type":"image","media_id":"abc-123"}]}],"visibility":"public"}'
+```
+
+## Mini App Icon Workflow
+
+Generate an icon for a mini app:
+
+```bash
+# 1. Generate icon (square, no rounded corners - iOS adds those automatically)
+cue image "your app description, minimal flat design" \
+  -o /tmp/icon.png --aspect-ratio 1:1
+
+# 2. Deploy with icon (auto-uploads to S3)
+cue app deploy '{"app_id":"my-app","name":"My App","version":"1.0.0"}' \
+  --bundle ./dist/release/bundle.js \
+  --icon /tmp/icon.png
+
+# 3. Publish
+cue app publish my-app
+```
+
+Or update an existing app's icon:
+
+```bash
+# 1. Generate new icon
+cue image "updated app icon design" -o /tmp/new-icon.png -a 1:1
+
+# 2. Upload and update (manual for now)
+# See mini-apps skill for full workflow
+```
+
+## Prompt Tips
+
+### For app icons
+
+- Use "minimal flat design" or "flat icon" for clean icons
+- **Do NOT include "iOS app icon style"** - this adds rounded corners which iOS applies automatically
+- Specify colors: "blue and white", "gradient purple to pink"
+- Mention the app purpose: "recipe app", "fitness tracker", "puzzle game"
+- Always use `--aspect-ratio 1:1` for square icons
+
+### For illustrations
+
+- Specify style: "watercolor", "digital art", "photorealistic", "cartoon"
+- Describe mood: "cozy", "energetic", "serene", "dramatic"
+- Include lighting: "golden hour", "neon lights", "soft diffused light"
+
+## Output
+
+Images are saved as PNG files. The command outputs the saved path:
+
+```
+Generating image: "a cocktail recipe app icon, colorful martini..."
+Image saved to: /tmp/cocktail-icon.png
+```
+
+## Troubleshooting
+
+| Error                  | Fix                                                    |
+| ---------------------- | ------------------------------------------------------ |
+| Not authenticated      | Run `cue` then `/auth` to log in                       |
+| Authentication expired | Re-authenticate with `/auth`                           |
+| Invalid aspect ratio   | Use supported ratio (1:1, 16:9, 9:16, etc.)            |
+| 4K not working         | Only available with `gemini-3-pro-image-preview` model |
+| Generation failed      | Check prompt for policy violations, simplify if needed |
+
+## Related
+
+- [posts skill](../posts/SKILL.md) - Creating posts with images
+- [mini-apps skill](../mini-apps/SKILL.md) - Deploying apps with icons

package/dist/skills/like/SKILL.md

@@ -0,0 +1,66 @@
+---
+name: like
+description: Like and bookmark posts. Accepts share IDs (short) or UUIDs.
+category: comms
+type: context
+metadata:
+  short-description: Post likes and bookmarks
+  scope: first-party
+---
+
+Like and bookmark posts via CLI. Accepts both share IDs (short, like `xK7bQ2mP`) and full UUIDs.
+
+## Requirements
+
+- `cue` CLI installed and authenticated (`cue` then `/auth`)
+
+## Usage
+
+### Like a post
+
+```bash
+cue like <post_id_or_share_id>
+```
+
+### Unlike a post
+
+```bash
+cue unlike <post_id_or_share_id>
+```
+
+### Bookmark a post
+
+```bash
+cue bookmark <post_id_or_share_id>
+```
+
+### Remove a bookmark
+
+```bash
+cue unbookmark <post_id_or_share_id>
+```
+
+## Share ID Support
+
+Posts have short share IDs (e.g., `xK7bQ2mP`) in addition to UUIDs. The CLI auto-detects which format you're using and resolves share IDs to UUIDs before calling the API.
+
+```bash
+cue like xK7bQ2mP              # Using share ID
+cue like 3cf5ad1c-...           # Using UUID
+cue bookmark xK7bQ2mP           # Bookmark with share ID
+```
+
+## Use a specific account
+
+```bash
+cue --profile cue:<account> like <post_id>
+cue --profile cue:<account> bookmark <post_id>
+```
+
+## Troubleshooting
+
+| Error                      | Fix                                        |
+| -------------------------- | ------------------------------------------ |
+| Not authenticated          | Run `cue` then `/auth` to log in           |
+| Post not found             | Check the post ID or share ID              |
+| Could not resolve share ID | Share ID doesn't exist or post was deleted |

package/dist/skills/listen/SKILL.md

@@ -0,0 +1,57 @@
+---
+name: listen
+description: Record from microphone and transcribe speech to text using local Whisper. Use when user wants to speak or dictate instead of typing.
+category: media
+type: hybrid
+metadata:
+  scope: first-party
+  requires:
+    bins: [whisper]
+---
+
+# Listen
+
+Record from microphone and transcribe to text using local Whisper (free, no API key).
+
+## Requirements
+
+- `whisper` (local): `brew install openai-whisper`
+- `sox` (for recording): `brew install sox`
+- Microphone permissions granted to terminal app
+- Debug temp files (optional): `CUE_LISTEN_KEEP_TEMP=1 cue listen ...` keeps `/tmp/cue-listen-*` files
+
+## Usage
+
+```bash
+# Record for default 5 seconds, then transcribe
+<skill-dir>/scripts/listen.sh
+
+# Record for 10 seconds
+<skill-dir>/scripts/listen.sh --duration 10
+
+# Use a larger model for better accuracy (base, small, medium, large)
+<skill-dir>/scripts/listen.sh --model medium
+
+# CLI command wrapper
+cue listen
+cue listen --duration 30
+cue listen --model medium -o transcript.txt
+```
+
+## Models
+
+| Model    | Speed        | Accuracy              | Size  |
+| -------- | ------------ | --------------------- | ----- |
+| `base`   | Fast (~2s)   | Good for clear speech | 142MB |
+| `small`  | Medium (~5s) | Better                | 466MB |
+| `medium` | Slow (~10s)  | Great                 | 1.5GB |
+| `large`  | Slowest      | Best                  | 2.9GB |
+
+Default is `base` for speed. Use `medium` if accuracy is important.
+
+## How it works
+
+1. Records audio from default microphone (via `sox` or `ffmpeg`)
+2. Saves as WAV (16kHz mono)
+3. Transcribes locally with Whisper
+4. Outputs text to stdout

package/dist/skills/listen/scripts/listen.sh

@@ -0,0 +1,74 @@
+#!/bin/bash
+# Record from microphone and transcribe with Whisper
+# Usage: listen.sh [--duration SECONDS] [--model MODEL]
+
+DURATION=5
+MODEL="base"
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+TMPBASE="/tmp/cue-listen-$$"
+TMPWAV="$TMPBASE.wav"
+WHISPER_STDERR="$TMPBASE.whisper.stderr.log"
+KEEP_TEMP="${CUE_LISTEN_KEEP_TEMP:-0}"
+
+while [[ $# -gt 0 ]]; do
+  case $1 in
+    --duration|-d) DURATION="$2"; shift 2 ;;
+    --model|-m) MODEL="$2"; shift 2 ;;
+    *) shift ;;
+  esac
+done
+
+cleanup() {
+  if [ "$KEEP_TEMP" = "1" ]; then
+    echo "Debug: keeping temp listen files at $TMPBASE.* (CUE_LISTEN_KEEP_TEMP=1)" >&2
+    return
+  fi
+  rm -f "$TMPWAV" "$WHISPER_STDERR" "$TMPBASE"*.txt "$TMPBASE"*.json "$TMPBASE"*.srt "$TMPBASE"*.vtt "$TMPBASE"*.tsv
+}
+trap cleanup EXIT
+
+# Record using Swift (works on macOS with proper mic permissions)
+swift "$SCRIPT_DIR/record.swift" --duration "$DURATION" --output "$TMPWAV"
+if [ $? -ne 0 ] || [ ! -s "$TMPWAV" ]; then
+  exit 1
+fi
+
+# Transcribe with Whisper
+if ! command -v whisper &>/dev/null; then
+  echo "Error: whisper not found. Install: brew install openai-whisper" >&2
+  exit 1
+fi
+
+if ! whisper "$TMPWAV" --model "$MODEL" --output_format txt --output_dir /tmp --language en --fp16 False 2>"$WHISPER_STDERR"; then
+  if [ -s "$WHISPER_STDERR" ]; then
+    cat "$WHISPER_STDERR" >&2
+  fi
+  echo "Error: whisper command failed" >&2
+  exit 1
+fi
+
+TXTFILE=""
+for candidate in "$TMPBASE.txt" "/tmp/$(basename "$TMPWAV").txt"; do
+  if [ -f "$candidate" ]; then
+    TXTFILE="$candidate"
+    break
+  fi
+done
+
+if [ -z "$TXTFILE" ]; then
+  if [ -s "$WHISPER_STDERR" ]; then
+    cat "$WHISPER_STDERR" >&2
+  fi
+  echo "Error: whisper did not produce a transcript file in /tmp" >&2
+  exit 1
+fi
+
+if [ ! -s "$TXTFILE" ]; then
+  if [ -s "$WHISPER_STDERR" ]; then
+    cat "$WHISPER_STDERR" >&2
+  fi
+  echo "Error: transcript is empty. Check microphone permissions/input and speak while recording." >&2
+  exit 1
+fi
+
+cat "$TXTFILE"

package/dist/skills/listen/scripts/record.swift

@@ -0,0 +1,94 @@
+#!/usr/bin/env swift
+
+import AVFoundation
+import Foundation
+
+let args = CommandLine.arguments
+var duration: Double = 5
+var outputPath = "/tmp/cue-recording.wav"
+
+var i = 1
+while i < args.count {
+    switch args[i] {
+    case "--duration", "-d":
+        i += 1
+        duration = Double(args[i]) ?? 5
+    case "--output", "-o":
+        i += 1
+        outputPath = args[i]
+    default:
+        break
+    }
+    i += 1
+}
+
+let url = URL(fileURLWithPath: outputPath)
+try? FileManager.default.removeItem(at: url)
+
+let authStatus = AVCaptureDevice.authorizationStatus(for: .audio)
+if authStatus == .denied || authStatus == .restricted {
+    fputs("Error: microphone access is denied.\n", stderr)
+    fputs("Grant access in: System Settings → Privacy & Security → Microphone\n", stderr)
+    exit(1)
+}
+
+if authStatus == .notDetermined {
+    let semaphore = DispatchSemaphore(value: 0)
+    var granted = false
+    AVCaptureDevice.requestAccess(for: .audio) { allowed in
+        granted = allowed
+        semaphore.signal()
+    }
+    _ = semaphore.wait(timeout: .now() + 10)
+    if !granted {
+        fputs("Error: microphone permission was not granted.\n", stderr)
+        fputs("Grant access in: System Settings → Privacy & Security → Microphone\n", stderr)
+        exit(1)
+    }
+}
+
+let audioDevices = AVCaptureDevice.devices(for: .audio)
+if audioDevices.isEmpty {
+    fputs("Error: no audio input device detected.\n", stderr)
+    fputs("This Mac appears to have no active microphone input.\n", stderr)
+    fputs("Connect a USB/Bluetooth microphone and select it in System Settings → Sound → Input.\n", stderr)
+    exit(1)
+}
+
+let settings: [String: Any] = [
+    AVFormatIDKey: Int(kAudioFormatLinearPCM),
+    AVSampleRateKey: 16000,
+    AVNumberOfChannelsKey: 1,
+    AVLinearPCMBitDepthKey: 16,
+    AVLinearPCMIsFloatKey: false,
+]
+
+guard let recorder = try? AVAudioRecorder(url: url, settings: settings) else {
+    fputs("Error: could not create recorder. Check microphone permissions.\n", stderr)
+    fputs("Grant access in: System Settings → Privacy & Security → Microphone\n", stderr)
+    exit(1)
+}
+
+fputs("Recording for \(Int(duration))s... (speak now)\n", stderr)
+recorder.prepareToRecord()
+recorder.record(forDuration: duration)
+
+Thread.sleep(forTimeInterval: duration + 0.5)
+recorder.stop()
+
+let fileSize = (try? FileManager.default.attributesOfItem(atPath: outputPath)[.size] as? Int) ?? 0
+let frameCount = (try? AVAudioFile(forReading: url).length) ?? 0
+
+if frameCount <= 0 {
+    fputs("Error: recording captured no audio frames.\n", stderr)
+    fputs("System Settings → Privacy & Security → Microphone → enable your terminal app\n", stderr)
+    fputs("Also check your input device and speak while recording.\n", stderr)
+    exit(1)
+}
+
+if fileSize <= 1000 {
+    fputs("Error: recording failed or too short.\n", stderr)
+    exit(1)
+}
+
+fputs("Saved: \(outputPath) (\(fileSize) bytes, frames=\(frameCount))\n", stderr)

package/dist/skills/markdown-to-pdf/SKILL.md

@@ -0,0 +1,31 @@
+---
+name: markdown-to-pdf
+description: Convert Markdown files to PDF via `cue md-to-pdf`. Use when user wants a local PDF export of notes, docs, plans, or proposals.
+category: dev
+type: context
+metadata:
+  short-description: Convert Markdown to PDF
+  scope: first-party
+---
+
+Convert Markdown files into polished PDFs locally.
+
+## Requirements
+
+- Node 20+
+- Google Chrome or Chromium installed, or `CHROME_PATH` set explicitly
+
+## Usage
+
+```bash
+cue md-to-pdf input.md output.pdf
+cue md-to-pdf notes/today.md /tmp/today.pdf
+cue md-to-pdf docs/roadmap.md roadmap.pdf --json
+```
+
+## Notes
+
+- Relative images and links are resolved from the Markdown file location
+- Output path should end in `.pdf`
+- `--json` returns structured `{ input, output }` metadata for scripting
+- This skill is the thin discovery layer; the maintained implementation lives in Cue CLI TypeScript code

package/dist/skills/message/SKILL.md

@@ -0,0 +1,136 @@
+---
+name: message
+description: Manage inbox conversations and low-level conversation messages with `cue inbox` and `cue message`.
+category: comms
+type: context
+metadata:
+  short-description: Inbox and messaging
+  scope: first-party
+---
+
+Manage inbox conversations and send/read messages via CLI.
+
+## Requirements
+
+- `cue` CLI installed and authenticated (`cue` then `/auth`)
+- Network access
+- For `cue inbox sync` or `cue message send --to <name>`:
+  - Agent workspace configured (`cue agent init` or `--agent <name>`)
+
+## Quick Start
+
+### Command help
+
+```bash
+cue inbox -h
+cue message -h
+```
+
+### List conversations
+
+```bash
+cue inbox
+cue inbox list
+```
+
+### Sync inbox for name-based targeting
+
+```bash
+cue inbox sync
+cue message send --to "Project X" "[CLI] Ready for review"
+```
+
+### Send a message by conversation ID
+
+```bash
+cue message send <conversation_id> "[SCOPE] Your message here"
+```
+
+### Read recent messages
+
+```bash
+cue message read <conversation_id> 20
+```
+
+## Message Format
+
+Include scope prefix for clarity:
+
+```
+[CLI] Fixed notify to accept both positional and named flag syntax
+[Backend] Added /api/v1/foo endpoint - CLI agents can now use it
+[iOS] WebSocket reconnect issue fixed
+[Sandbox] Network blocked, cannot send notifications
+```
+
+## When to Post
+
+- Found a bug that affects other agents/scopes
+- Need something from another scope (API endpoint, feature, fix)
+- Discovered a gotcha that others should know
+- Blocked and need human or another agent's help
+- Completed work that unblocks other agents
+
+## Full CLI Usage
+
+### List your conversations
+
+```bash
+cue inbox                     # Default list command (default limit: 20)
+cue inbox list                # Explicit list command (default limit: 20)
+cue inbox list 50 --compact   # Compact human-readable output
+cue message list              # Compatibility alias for inbox listing
+```
+
+### Create a new group
+
+```bash
+cue inbox create "Group Name"
+cue inbox create "Project X" user-id-1 user-id-2
+```
+
+### Sync inbox locally
+
+```bash
+cue inbox sync
+cue inbox sync                # Default sync limit: 200
+cue inbox sync 200 --json
+```
+
+`cue inbox sync` downloads the backend inbox list into the local agent workspace.
+This is what powers name-based sends like `cue message send --to "Project X" ...`.
+
+### Send message to any conversation
+
+```bash
+cue message send <conversation_id> "Your message"
+cue message send --to "Project X" "Your message"   # Requires cue inbox sync
+```
+
+### Read messages from any conversation
+
+```bash
+cue message read <conversation_id>       # Default 20
+cue message read <conversation_id> 50    # Read 50
+cue message history <conversation_id>    # Alias for read
+```
+
+## Use a specific account
+
+```bash
+cue --profile cue:<account> inbox
+cue --profile cue:<account> inbox create "Group Name"
+cue --profile cue:<account> message send <conversation_id> "Message"
+cue --profile cue:<account> message read <conversation_id>
+```
+
+## Troubleshooting
+
+| Error                          | Fix                                                                   |
+| ------------------------------ | --------------------------------------------------------------------- |
+| Not authenticated              | Run `cue` then `/auth` to log in                                      |
+| fetch failed                   | Network blocked or backend unavailable                                |
+| No conversation found for name | Run `cue inbox sync` first, or send using a conversation ID           |
+| No agent workspace configured  | Run `cue agent init` or pass `--agent <name>` before `cue inbox sync` |
+| 403 Forbidden                  | Not a member of the conversation                                      |
+| 404 Not Found                  | Conversation ID incorrect                                             |