Loom CLI

Open workspaces or run prompts headlessly from your terminal

What You Can Do

With loom, you can:

  1. Open the app with a workspace
  2. Run headlessly — execute a prompt without the GUI and get output in the terminal

Headless results are saved to sessions, so you can review or continue in the app. Combine with shell scripts, CI/CD pipelines, or cron to automate repetitive workflows.

Install

Install from the Loom app:

  1. Go to Settings → Account → Loom CLI
  2. Click Install
  3. Open a new terminal and run loom --help

Quick Examples

# Open current folder as workspace
loom

# Open a specific workspace folder
loom /path/to/workspace

# Headless run
loom exec "Summarize TODOs in this project"

# Set model and output format
loom --model gpt-5 --json "Summarize recent changes"

Options

Execution

  • -C, --cd <dir>: workspace root (default: current directory)
  • -m, --model <model>: choose model (default: workspace setting)
  • --reasoning-effort <level> (--effort): reasoning hint (default: model default)

Output

  • --output-format text|json|stream-json: output format (default: text)
    • text — final assistant message only
    • json — one structured JSON result
    • stream-json — JSONL event stream
  • --json: shorthand for --output-format stream-json

Session

  • -c, --continue: continue latest session in workspace (default: new session)
  • --session-id <id> / -r, --resume <id>: continue a specific session

Mode Rules (Important)

  • loom and loom [path] open the desktop app by default.
  • loom exec ... or headless options (--model, --json, etc.) switch to headless mode.
  • Bare positional input is treated as a path.
    • Example: loom "hello" is treated as a path, not a prompt.
  • If headless options are present, positional input is treated as a prompt.
    • Example: loom --model gpt-5 "hello" runs in headless mode.

Troubleshooting

  • loom doctor: check CLI/app binary resolution
  • loom --help: show full option list