Log in Get started

Flow Commands Reference

docs/commands/readme.md

0.1.35.1 KB

Original Source

Flow Commands Reference

Complete documentation for all f (flow) commands.

Quick Reference

Command	Description
`deploy`	Deploy to Linux hosts, Cloudflare Workers, or Railway
`release`	Publish a release to registry or GitHub
`publish`	Publish project to GitHub
`install`	Install a CLI/tool via registry, parm, or flox
`clone`	Clone repositories with git-like destination behavior
`repos`	Clone repositories into ~/repos
`new`	Create a project from a local template in ~/new
`commit`	AI-powered commit with code review
`pr`	Create/open PRs and ingest GitHub feedback
`upstream`	Manage upstream fork workflow
`env`	Sync project environment and manage env vars
`invariants`	Validate project invariants from `flow.toml`
`fast`	Low-latency AI task invocation via fast client
`up`	Bring a project up with lifecycle conventions
`down`	Bring a project down with lifecycle conventions
`domains`	Shared local `*.localhost` route manager on port 80
`tasks`	List and run project tasks
`global`	Run tasks from global flow config
`setup`	Print aliases or run setup task
`ai`	Manage AI coding sessions (Claude + Codex)
`daemon`	Manage background daemons
`parallel`	Run tasks in parallel
`docs`	Manage auto-generated documentation
`web`	Open the Flow web UI for a project
`url`	Inspect or crawl URLs into compact AI-friendly summaries

Getting Started

bash

# Show all commands
f --help

# Get help for a specific command
f deploy --help
f commit --help

Command Categories

Deployment

deploy - Deploy to hosts and cloud platforms
release - Publish releases to registries
publish - Publish project to GitHub

Version Control

commit - AI-powered commits with review
pr - PR creation/editing plus review feedback ingestion
clone - Clone with git-like destination behavior
repos - Clone repos into a structured directory
upstream - Fork management and sync
fixup - Fix common TOML syntax errors

Task Management

tasks - List project tasks
fast - Run AI tasks through the low-latency fast client path
up - Start project lifecycle (up/dev) with optional domains setup
down - Stop project lifecycle with optional domains teardown
global - Run tasks from ~/.config/flow/flow.toml
setup - Print aliases or run setup task
run - Run a specific task
parallel - Run tasks in parallel
rerun - Re-run last task
search - Fuzzy search global commands

Process Management

ps - List running flow processes
kill - Stop running processes
logs - View task logs
daemon - Manage background daemons

AI & Development

ai - Manage AI coding sessions
url - Inspect or crawl URLs into compact summaries for AI use
agent - Invoke AI subagents
match - Match natural language to tasks
sessions - Search AI sessions across projects

Environment & Configuration

env - Manage environment variables
invariants - Validate invariant policies in flow.toml
domains - Shared local domain proxy ownership and route management
init - Scaffold a new flow.toml
doctor - Verify tools and integrations

Project Management

new - Create a project from a local starter in ~/new
projects - List registered projects
active - Show or set active project
hub - Ensure hub daemon is running

Documentation

docs - Manage auto-generated documentation
commits - Browse commits with AI metadata

Legacy Compatibility

recipe - Legacy recipe command (hidden; prefer tasks + .ai/tasks/*.mbt)

Other

skills - Manage Codex skills
install - Install binaries via registry/parm/flox
db - Manage databases and providers
tools - Manage AI tools
notify - Send proposal notifications
server - Start HTTP server for logs

Global Options

bash

-h, --help     Print help
-V, --version  Print version

Configuration

Flow uses flow.toml for project configuration. See flow.toml reference for full documentation.

See Also