CLI
Commands of the rungflo CLI.
rungflo <command> [positionals] [flags]Run rungflo <command> --help for each command's parameters. The MCP server (rungflo mcp) exposes the same commands as tools. It adds a kit tool that returns your rules, memory, and skills list, and loads a skill by name.
Account and records
| Command | What it does |
|---|---|
login | Sign in with a browser device code. |
mcp | Serve the shared record tools over stdio. |
import | Import the default branch and linked open PR plans into records. |
export <dir> | Write project records as Markdown under <dir>. |
pull | Refresh the read-only .rungflo-records/ folder for agents. |
Plans
| Command | What it does |
|---|---|
rungs | List the project's rungs in order, with ID, title, and outcome. |
features | List features, or read one with --feature-id. |
plans | List plans with ID, stage, rung, and title. |
next | Read the first ready plan: no open or merged PR, every dependency done, unheld. Current rung first, then the plan the most unfinished plans wait on. Says why, and does not claim it. |
plan <id> | Read a plan. Revise with --file and --base, or create with --create --file. |
feature <id> | Create or update a feature from feature-file Markdown. |
rung | Create or update a rung. New rungs go last unless a position is given. |
tick <id> <n> | Tick or untick (--undo) an acceptance criterion. Names the member, agent, and PR. |
Sessions
| Command | What it does |
|---|---|
claim <id> | Claim a plan for the calling member and agent. Returns its session and full plan. |
helper <session> | Add a helper agent to your lead session. Only the lead can complete or release. |
checkpoint <session> | Record --done, --decision, --drift, and --next items with a --status. |
checkpoints <id> | Read a plan's past checkpoints from every session, oldest first. |
changes | Refresh a session with plan revisions and closed questions since its last read. |
ask | Open a question on a session or a plan. |
answer | Answer an open question. |
sessions | List active sessions, or all sessions, with their last checkpoint. |
release <session> | Release a claim without finishing. |
Agent kit
| Command | What it does |
|---|---|
kit pull | Write your rules and memory where Claude Code and Codex load them. |
kit push | Share memory files saved on this machine. |
kit push --skill <folder> | Share a skill folder, or every skill folder inside it. --scope is mine, project, or everywhere. |
kit pull --skill <name> | Write a skill's files to ~/.rungflo/kit/<project>/skills/<name>/, for a skill whose instructions run its scripts. |
kit token | Print a new API key that reads the kit and can't change it, for a cloud machine. |
kit setup <tool> | Print the setup-script lines that load the kit in capy, claude (Claude Code on the web), or codex (Codex cloud). |
rule add <text> | Add a rule every agent session follows. rule remove <name> removes one. |
Global flags
| Flag | Meaning |
|---|---|
--project <id> | Project ID. Overrides RUNGFLO_PROJECT and automatic project selection. |
--agent <name> | Agent name. Overrides RUNGFLO_AGENT and the detected client. |
--json | Print the success value as JSON. |