Skip to Content
rungFlo

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

CommandWhat it does
loginSign in with a browser device code.
mcpServe the shared record tools over stdio.
importImport the default branch and linked open PR plans into records.
export <dir>Write project records as Markdown under <dir>.
pullRefresh the read-only .rungflo-records/ folder for agents.

Plans

CommandWhat it does
rungsList the project's rungs in order, with ID, title, and outcome.
featuresList features, or read one with --feature-id.
plansList plans with ID, stage, rung, and title.
nextRead 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.
rungCreate 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

CommandWhat 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.
changesRefresh a session with plan revisions and closed questions since its last read.
askOpen a question on a session or a plan.
answerAnswer an open question.
sessionsList active sessions, or all sessions, with their last checkpoint.
release <session>Release a claim without finishing.

Agent kit

CommandWhat it does
kit pullWrite your rules and memory where Claude Code and Codex load them.
kit pushShare 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 tokenPrint 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

FlagMeaning
--project <id>Project ID. Overrides RUNGFLO_PROJECT and automatic project selection.
--agent <name>Agent name. Overrides RUNGFLO_AGENT and the detected client.
--jsonPrint the success value as JSON.

On this page