@promptfloe/cli

The PromptFloe command line — one binary, one brain. Generate a full app from a prompt, iterate on it, and ship it to Vercel or Netlify, all from your terminal.

Install

npm install -g @promptfloe/cli

This installs a single self-contained binary — no other setup required.

Windows: install fails with EPERM ... mkdir 'D:\' (or similar drive root)

This happens if you run the install command while sitting directly at a drive root (e.g. D:\>) rather than inside a folder, and/or without the -g flag. Windows blocks non-admin accounts from creating directories at a drive root, and npm's install process tries to do exactly that in this situation. Fix: cd into any real folder first, then install globally:

cd $env:USERPROFILE
npm install -g @promptfloe/cli
promptfloe --version

Quick start

# Authenticate (opens a device-flow login in your browser)
promptfloe login

# Generate a full app from a prompt
promptfloe build "a task tracker with add/complete/filter, Tailwind UI" --dir ./my-app

# Ship it
cd my-app
promptfloe ship --target vercel

# Or work conversationally instead
promptfloe chat

Bring your own model, or use PromptFloe-brokered credits

The CLI's local coding agent (promptfloe agent, promptfloe chat) needs a model to talk to. Two ways to configure that:

# BYO key - talk to Anthropic/OpenAI/Google directly with your own account
export ANTHROPIC_API_KEY=sk-ant-...

# Or use PromptFloe-brokered credits (no raw provider key handling)
export PROMPTFLOE_API_KEY=pf_...

promptfloe login authenticates your PromptFloe account (cloud sync, build/ship/status, etc.) — it's a separate concern from which model backs the local agent.

Commands

$ promptfloe --help

Usage: promptfloe <command> [--json] [--quiet] [--no-color]

Commands:
  build    generate a full app from a prompt: build "<prompt>" [--dir <path>]
  ship     deploy a built app: ship [--target vercel|netlify] [--dir <path>] [--name <project>]
  login    authenticate via device flow
  whoami   show login state
  logout   clear locally-stored credentials
  upgrade  show the installed version + how to update
  status   show your PromptFloe account plan + usage
  stats    interactive token usage + spend dashboard (alias: usage)
  sessions list your cloud-synced sessions (PROMPTFLOE_CLOUD_SESSIONS=1 to enable sync)
  apps     list your generated cloud apps
  keys     manage API keys for brokered inference: keys [list · create [<name>] · revoke <id>]
  pull     download a cloud app's files locally: pull <appId> [--dir <path>]
  iterate  edit a cloud app by prompt: iterate <appId> "<prompt>" [--tier fast|standard|pro] [--pull [--dir <path>]]
  logs     show a cloud app's latest-deployment logs: logs <appId>
  down     take a cloud app's live deployment offline: down <appId>
  schedule durable cloud routines: schedule create "<cron|@daily>" "<prompt>" [--llm] [--local] · list · rm <id>
  workflow run a multi-agent orchestration script: workflow run <name|path.mjs> [--args '<json>'] · list
  chat     start an interactive session (multi-turn REPL + slash commands)
  fleet    show the fleet roster and loading lexicon
  index    build/refresh the local structural index: index [--rebuild] [--json]
  symbols  search indexed symbols (fuzzy, ranked): symbols <query> [--json]
  outline  a file's ordered symbol tree: outline <path> [--json]
  agent    work a change in this repo: agent "<task>" [--write|--auto] [--verify]
  undo     revert a write-run's file changes: undo [--run <id>] [--force]
  checkpoints  list recent write-run checkpoints (read-only)
  config   view or set preferences: config [ads on|off]
  sponsors show the community sponsor board (opt-in, curated, display-only)

| Command | What it does | |---|---| | login / whoami / logout | Device-flow authentication and session state | | build "<prompt>" [--dir <path>] | Generate a full app from a prompt | | ship [--target vercel\|netlify] | Deploy a built app | | chat | Interactive multi-turn session with slash commands | | agent "<task>" [--write\|--auto] [--verify] | Work a change in the current repo (plan-first by default) | | status / stats (alias usage) | Account plan + usage, or an interactive token-spend dashboard | | apps / pull / iterate / logs / down | Manage your cloud-generated apps | | schedule / workflow | Durable cron-style routines and multi-agent orchestration scripts | | keys | Manage API keys for brokered inference | | index / symbols / outline | Local structural code index and lookups | | undo / checkpoints | Revert or inspect a write-run's file changes | | fleet | Show the fleet roster and loading lexicon |

Run promptfloe --help for the full, current list with flags.

License

UNLICENSED - proprietary. Free to install and use; source rights reserved.