agent-graph-flow

Features

Everything agf does

Every agf 0.31.2 command, explained in one sentence and grouped by what you want to do.

256 features in 14 groups

Get started and install

Set up the project, check your environment and find the right command.

  • agf init

    Sets agf up in your project: configures it, checks the environment and starts the web dashboard.

  • agf welcome

    Quick orientation that spends no tokens: project numbers, the next task and the skills for each phase.

  • agf help

    A friendly index of the commands, with an overview and first steps.

  • agf retrieve-command

    Describe what you want in plain language and get the exact agf command back.

  • agf reference

    Prints the agf reference guide (tools, skills, phases and gates), optionally filtered by phase.

  • agf doctor

    Checks whether your environment is ready to run agf and points out what is missing.

  • agf upgrade

    Updates the agf binary to the latest published version.

  • agf config

    Reads, changes or lists the project settings.

  • agf preset

    Lists, shows and applies ready-made workflow presets, such as default or strict-tdd.

  • agf install-neural

    Installs the local model that enables meaning-based search (embeddings) in the project.

  • agf principles

    Shows the engineering principles that guide agf, grouped by theme.

  • agf recent

    Lists the project folders you used recently.

Plan the work

Turn an idea into a task graph with acceptance criteria you can test.

  • agf import-prd

    Imports a requirements document (.md, .txt, .pdf, .html) into the task graph, with acceptance criteria on each task.

  • agf generate-prd

    Generates a requirements document with testable acceptance criteria; with --import it becomes a task graph right away.

  • agf genesis

    Creates a project from scratch: from idea to task graph and the first instructions for the agent, in one step.

  • agf node

    Creates, shows, changes, moves, clones and removes items in the task graph.

  • agf node add

    Adds a task, epic, risk or decision to the task graph.

  • agf edge

    Creates, lists and removes links between items in the task graph.

  • agf edge add

    Links two items, for example saying one task depends on another.

  • agf decompose

    Finds tasks that are too big and suggests how to split them into small parts.

  • agf gaps

    Points out what the plan is missing (criteria, tests, requirements without tasks) and the command to fix each one.

  • agf template

    Reusable task breakdown templates: list and apply.

  • agf template apply

    Creates tasks and links from a template, filling in the variables you pass.

  • agf sequence

    Puts the child tasks of an item in a queue, each depending on the previous one, by creation order.

  • agf ac

    Strengthens weak acceptance criteria by rewriting them as Given-When-Then.

  • agf verify-ac

    Checks whether existing code already meets a task’s criteria before you build it from scratch.

  • agf sprint

    Plans, reviews and runs the retrospective of a sprint, all recorded in the task graph.

  • agf sprint plan

    Records the sprint scope, linking it to each included task.

  • agf risk

    Organizes open risks: promote, accept or close.

  • agf risk triage

    Triages open risks; by default it only shows what it would do.

  • agf question

    Records questions for a person to answer, and lists, answers or rejects the pending ones.

  • agf replan-analyze

    Checks sprint health (tasks taking longer than expected, parents blocking children) and suggests a replan.

  • agf cycle-repair

    Finds circular dependencies between tasks and proposes how to break them; by default it only reports.

  • agf spec-triage

    Lists requirements, interfaces and contracts in the graph that no task implements yet.

  • agf mrd

    Suggests graph items to merge, review or retire, using only data already stored.

  • agf import-graph

    Merges an exported JSON task graph into the project.

  • agf reclassify-structural

    Marks items that are only organizing headings (like “Roadmap”) as not implementable.

  • agf backfill-provenance

    Fills in the missing source file on graph items by inheriting it from the closest parent.

  • agf migrate-ac

    Migration tool: moves old acceptance criteria stored as child items into the task itself.

Do a task (the cycle)

Pick a task, build it test-first and close it only when it is proven.

  • agf next

    Hands you the next unblocked task to work on, one at a time.

  • agf start

    Starts the next task in one step: picks it, gathers context and marks it in progress.

  • agf context

    Builds a compact summary of everything the agent needs to know about a task.

  • agf preflight

    Before coding, checks git and the graph to see if someone already did or is doing the same work.

  • agf brief

    Generates complete instructions for a task to hand to another agent to carry out.

  • agf node status

    Changes a task’s status (for example, to in progress or done), following the allowed flow.

  • agf test

    Runs the tests affected by the current task, or others you choose.

  • agf lint

    Runs eslint on just the affected files or on the whole project.

  • agf check

    Checks the task’s definition of done and whether it followed test-before-code.

  • agf done

    Closes the task: checks the definition of done, runs tests, saves what was learned and suggests the next one.

  • agf submit

    Takes in the result from an agent that worked from instructions, validates it, tests it and closes the task.

  • agf commit-scope

    Commits only the files declared on the task, without sweeping in other people’s changes.

  • agf implementer

    Lets an external agent report that it started, progressed or finished a task, with validation.

  • agf role

    Records or shows which role (implementer, reviewer or validator) is assigned to a task.

  • agf artifacts

    Stores and fetches structured subtask results, such as diffs, files, interfaces, decisions and notes.

  • agf release

    Puts a task you started but never touched back in the queue; refuses if it already has commits.

  • agf wait

    Waits until a condition holds (machine has room, merge is free, push is done) without you checking by hand.

Track progress

See where the project stands, what is stuck and when it should finish.

  • agf dashboard

    Opens the local web dashboard with the task graph and the cost savings tab.

  • agf stats

    Shows how many items and links the graph has, by type and status.

  • agf kanban

    Draws the Kanban board: status columns, work-in-progress limit and flow metrics.

  • agf tui

    Opens the interactive terminal interface, with the graph and token usage.

  • agf insights

    Graph analytics without AI: delivery metrics, bottlenecks and phases.

  • agf forecast

    Forecasts when the backlog will finish, simulating 10,000 scenarios from the real weekly pace.

  • agf leadtime

    Shows how long tasks take at each stage and which have been sitting the longest.

  • agf epic

    Tracks each epic: tasks done, already on main and with proof that it works.

  • agf epic track

    Shows milestone progress: child tasks done, on main and with a passing proof.

  • agf okr

    One line per epic: the objective, how much of the key results was reached and the status.

  • agf phase

    Shows the lifecycle phases and detects which one the project is in.

  • agf ui

    Opens a simple web progress page (graph, tokens and live logs) on the port you choose.

  • agf export

    Exports the task graph as JSON, CSV or a Mermaid diagram.

  • agf dora

    The 5 DORA metrics (frequency, lead time, failure, restore, rework) and first-try success.

  • agf evm

    Earned value for an epic (CPI, SPI and forecast final cost) from the estimates.

  • agf flow-model

    Little's Law per flow stage and the predicted gain if you change the load.

  • agf overhead

    Shows how much time goes to gates, evaluation and retries, per task or overall.

  • agf retro

    Round retrospective: the 3 biggest bottlenecks and how throughput and lead time changed.

  • agf inbox

    Shows the graph events for your session: tasks done, assigned and merged.

Quality and proof

Confirm the work is really done, with tests and quality gates.

  • agf certainty

    Answers “is it really done?” for a task, showing each piece of evidence behind the verdict.

  • agf gate

    Runs the gates that say whether the project can move to the next phase (analysis, design, review, deploy and others).

  • agf validate

    Runs read-only checks: acceptance criteria, readiness, done, integrity and flow.

  • agf harness

    Scores from 0 to 100 how ready the code is for agents to work on (types, tests, docs, naming).

  • agf ci

    Runs the continuous integration steps in order and stops at the first failure.

  • agf quality

    Quality gate over src/: fails if tests and logs fall below 95%.

  • agf quality-policy

    Quality rules that block or just warn when a metric crosses its limit.

  • agf guardrail

    Saved quality checks that run before and after an action, failing open or closed.

  • agf scan

    Gathers into one list the problems found by quality score, types, security and tainted-data analysis.

  • agf tdd-score

    Gives a 0 to 100 score for the quality of a task’s tests.

  • agf lint-files

    Fails if any source file goes over 800 lines.

  • agf scan-silent-failures

    Searches the code for shortcuts that hide errors, such as empty catch blocks or “|| []”.

  • agf wire-check

    Flags code paths that only run with mock data and that no real code turns on.

  • agf wire-dormant

    Lists features that are built but not connected to anything and creates tasks to connect them; by default it only shows.

  • agf suite

    When the full test suite is red, organizes the failures into tasks.

  • agf suite triage

    Creates one task per broken test file, without duplicating those already open.

  • agf eval

    Runs real scenarios and produces a scorecard: success rate, cost per success, tokens and time.

  • agf dataset

    Stores evaluation datasets, created by hand or from real runs and decisions.

  • agf scenario

    Runs agf’s self-check, which tests its own code with mutations and properties on a real in-memory database.

  • agf provenance

    Ranks each claim by how well it is backed: claimed, cited, validated or proven.

  • agf provenance promote

    Moves a task up a proof level, only if the required evidence exists in the graph.

  • agf estimate-defects

    Estimates how many defects are still undiscovered by comparing what two independent reviews found.

  • agf lifecycle

    Runs every analysis for one lifecycle phase and combines them into one report.

  • agf immune

    Looks for error patterns in the code and runs a detect-and-recover cycle, keeping a history.

  • agf canary

    Canary tasks whose criteria are locked to a test, to check agents do not cheat.

  • agf candidates

    Runs the same task several times in separate folders and keeps the one that passed the tests.

  • agf claim-check

    Checks what the agent claims it did against the real files and tests.

  • agf proof

    Suggests the usage proof that tells the code before and after the task apart.

  • agf judge

    A panel of judges that grade the delivery: brief, votes, status and calibration.

  • agf andon

    Stops the line when something serious happens and only releases it after the fix.

Security and safeguards

Decide what agents may run and keep a record of what they did.

  • agf guard

    Classifies a command, path or address as allowed, ask first or denied.

  • agf guard check

    Checks a command before it runs and returns an error when it should be blocked.

  • agf permissions

    Sets per project which actions and resources are allowed, denied or need asking.

  • agf approval

    Creates, grants, verifies and revokes authorizations for actions that need approval.

  • agf approval wait

    Waits for a person to approve the task (through a signal file) before continuing.

  • agf audit

    Looks up the history of tools the agents called.

  • agf sandbox

    Detects the project stack (npm, maven, gradle, go, pip) and runs builds isolated from the rest of the system.

  • agf sandbox run

    Runs any agent CLI inside a container, with no network and only the declared variables.

  • agf exec-policy

    Checks whether a shell command can run directly, needs approval or is forbidden.

  • agf sandbox-gate

    Checks whether a command follows the file and network access rules.

  • agf env

    Shows environment variables filtered by prefix, hiding secrets.

  • agf scan-binaries

    Writes the trust record for a release: hash, signature and VirusTotal result.

  • agf approve

    Approves a run that stopped waiting for a person and resumes where it left off.

  • agf reject

    Denies a run that was waiting for approval; the next steps do not run.

Many agents (colony)

Coordinate many agents on one task graph, each in its own isolated copy of the project.

  • agf colony

    Views for whoever leads the colony: what was delivered, what is in progress, blocked or in the backlog.

  • agf colony report

    Shows colony status: delivered, in progress, blocked, priorities and backlog.

  • agf colony bootstrap

    Opens the colony from the backlog: creates the isolated project copies and the commands for each session.

  • agf colony round

    Automatic round: refills work, lists idle agents and what is ready to merge into main.

  • agf colony standup

    Standup per agent: what it delivered since the last round, what it is doing and what is blocking it.

  • agf review brief <id>

    Builds the reviewer's isolated brief: criteria, diff and receipts, never the executor's account.

  • agf review submit <id>

    Records the independent reviewer's verdict, signed and tied to the exact code version.

  • agf colony review

    Lists merges into main made by worker agents and merges with no identity.

  • agf ant

    Creates, lists and removes each agent’s isolated copy of the project, all sharing one task graph.

  • agf ant spawn

    Creates (or reuses) an agent’s isolated copy of the project and returns the ready-made variables.

  • agf ant merge

    Merges an agent’s work into main in one call, running types, tests and lint on the touched files.

  • agf ant gc

    Removes agents’ isolated copies and branches already merged into main; by default it only shows.

  • agf assign

    Assigns a task to an agent; that agent’s agf next then hands it this task first.

  • agf claims

    Shows which agents are holding which tasks right now.

  • agf bottlenecks

    Points out colony bottlenecks (overloaded machine, stalled tasks, idle agents) with the owner and the command to fix them.

  • agf colony-health

    Shows colony health and its measurement history.

  • agf caste

    Lists the colony’s agent types and, for each, the model tier, maximum complexity and task types.

  • agf swarm

    Optional coordination between agents: sessions, resource reservations, messages and voting.

  • agf swarm agents

    Shows each agent’s live status: heartbeat, locks and current task.

  • agf batch-select

    Groups up to N small, unblocked tasks to hand out in one round (read-only).

  • agf adopt

    Takes over the tasks of agents that are no longer running, recording who took them.

  • agf freeze

    Freezes the colony on an epic: agents only get its tasks until you release it.

  • agf signal

    Sends a message to another agent (or all of them) through the graph, including a stop request.

  • agf mission

    Takes a mission end to end: research, design, build, integration, review and shipping.

Autopilot and execution

Let agf drive tasks on its own, within limits, or repeat commands in a loop.

  • agf autopilot

    Works through tasks on its own, one at a time: picks, builds, checks the definition of done and closes or asks for help.

  • agf deliver

    From request to delivery: turns text, a file or an image into requirements, a task graph and tested code.

  • agf build

    Drives the whole delivery: requirements, graph, task breakdown, autopilot and delivery.

  • agf run

    Implements a one-off request in a single run: generates the code, applies it and tests it (via the Copilot SDK).

  • agf loop

    Runs an agf command on an interval, or repeats until a success rubric passes.

  • agf loop start

    Starts a loop in the background, without holding the terminal.

  • agf exec

    Runs several agf commands in sequence.

  • agf pipeline

    Compound commands that do several operations at once, opening the graph only once (faster).

  • agf checkpoint

    Runs work in steps and resumes from the last finished step; a step can wait for approval.

  • agf checkpoint-schedule

    Schedules step-by-step runs on a timetable (cron).

  • agf schedule

    Schedules prompts to the agent on a timetable (cron).

  • agf webhook

    Starts step-by-step runs when a signed HTTP call arrives.

  • agf longrun

    Keeps an eye on long runs: status, heartbeat and daily report.

  • agf automate

    Proposes, adopts and reviews automations by comparing before and after.

  • agf slot

    A queue for heavy commands, so the machine does not freeze running several at once.

Models, cost and token savings

Choose the model, see what you spend and cut tokens without losing results.

  • agf provider

    Chooses and shows the model provider (Copilot by default, or OpenAI-compatible services).

  • agf provider use

    Sets the project’s active provider, including the address of a local or remote server.

  • agf model

    Chooses or shows the model; with auto, agf picks a suitable model for each task.

  • agf status

    One panel: provider, model, cache, tokens, dollars spent and savings.

  • agf savings

    Running table of input, output and cache tokens and cost saved.

  • agf metrics

    Shows how many tokens each task and session used in automatic mode.

  • agf economy

    Turns on, turns off and lists the optional token-saving techniques.

  • agf economy list

    Lists each saving technique, whether it is on and how many tokens it has saved.

  • agf compress

    Shortens tool output before the agent reads it, with filters per command type.

  • agf compress run

    Runs a command and returns its output already compressed (or compresses what comes from stdin).

  • agf cache

    Shows prompt cache statistics.

  • agf retrieve

    Gets back the original text that was compressed, using the code left in its place.

  • agf recall

    Prints a stored full output byte for byte, by its code.

  • agf login

    Connects your GitHub Copilot account for agf to use as a provider.

  • agf logout

    Removes the saved GitHub Copilot access.

  • agf gearshift

    Manually picks a gear from 1 to 4 for model and effort, reflected in the Claude Code settings.

  • agf profile

    Ready-made work bundles that combine model tier, flow and number of retries.

  • agf flow

    Turns on, turns off and shows flow, a formula that reduces the context sent to the model.

  • agf calibrate

    Suggests, from savings already measured, the confidence level at which context retrieval pays off.

  • agf ponytail

    Shows or changes the ponytail level (the mode that asks agents for the simplest solution) and where the value came from.

  • agf codemode

    The agent writes a small program that calls the tools instead of calling them one by one, spending fewer tokens.

  • agf proxy

    A local OpenAI-compatible proxy that applies agf savings and records every call.

  • agf discover

    Shows the command outputs that still reach the agent unfiltered, so you know what to compress.

  • agf capture

    Decides how much of a tool output to keep (nothing, a reference or all of it) to look up later.

  • agf export-dataset

    Exports the approved examples of a task to a file for training models.

Learning and memory

Keep what the project learned so the next agents make fewer mistakes.

  • agf memory

    Writes, reads, lists, searches and deletes project memories.

  • agf memory write

    Saves a memory, from inline text or from a file.

  • agf skill

    Lists and shows skills, which are ready-made instructions for agents.

  • agf skill list

    Lists the skills available in the project and in your CLI.

  • agf learning

    Stored learning: each agent’s performance, agent choice and export.

  • agf learning route

    Suggests which agent should take the task, based on history.

  • agf learn

    Reads a Claude session, finds where a command failed and then worked, and lists the correction rules.

  • agf learn-eval

    Measures how often the automatic learning gets its choices right.

  • agf dream

    Knowledge consolidation cycles inspired by sleep: start, status, history and cancel.

  • agf knowledge-compile

    Turns a knowledge text into a structured page, with links and a version.

  • agf knowledge-learn

    Brings in memories, decisions and patterns from another project’s graph.

  • agf knowledge-lint

    Checks the stored knowledge and points out problems, without deleting anything.

  • agf federation

    Shares knowledge across projects: registers other projects and pulls in what they learned.

  • agf prediction-feedback

    Stores wrong predictions and their corrections so the agent can check them before repeating a mistake.

  • agf trace

    Keeps execution records, with the steps and the cost and time of each.

  • agf usage

    Tracks which commands you use most, shows trends and generates automatic shortcuts.

  • agf rem

    Tidies memory: merges near-duplicate memories and archives unused ones, without deleting anything.

  • agf kb

    Knowledge base: search and read; proposes and confirms new items but never publishes on its own.

  • agf harvest

    When the queue runs dry, gathers what was left behind: idle ideas, open risks and loose criteria.

Context and code search

Find what you need in the graph and the code, reading only what is necessary.

  • agf search

    Searches the text of task graph items, ranking the most relevant first.

  • agf query

    Filters graph items by type, status, parent or text.

  • agf code

    Code intelligence: index, search, navigate and measure the impact of a change.

  • agf code index

    Indexes the project code (functions, classes and who calls whom).

  • agf code skeleton

    Shows only a file’s signatures, without function bodies: about 10 times smaller than reading it.

  • agf code impact

    Shows what may break if a file changes.

  • agf read

    Reads a source file; in aggressive mode it shows only the signatures.

  • agf smart

    Summarizes a source file in 2 lines, without using AI.

  • agf diff

    Compares two files and shows the difference compactly.

  • agf log

    Shows a log without repeats: identical lines become one with a count.

  • agf err

    Runs a command and shows only its errors.

  • agf deps

    Summarizes the project dependencies per manifest file, without running the package manager.

  • agf lsp

    Shows the status of the configured language servers.

  • agf docs

    Stores and searches library documentation, and generates living docs from the graph.

  • agf docs generate

    Generates agent-oriented documentation from the graph, without spending tokens.

  • agf web-search

    Searches the web via Exa or Tavily, without duplicates and ranked by relevance.

  • agf parse-api

    Reads an OpenAPI or WSDL spec and extracts the endpoints and data shapes.

  • agf scaffold

    Generates ready code skeletons (class, function, component) for a task, without AI by default.

  • agf montar-output

    Internal tool: for a goal, finds a ready output skeleton and fills in the blanks, or generates a new one.

  • agf scan-repos

    Examines neighboring repositories and compares what they do with what agf already does.

Specs, documents and decisions

Record principles, specs and decisions so nobody has to decide twice.

  • agf constitution

    Manages the project principles and checks whether the work follows them.

  • agf adr

    Architecture decision records: create and list.

  • agf adr create

    Creates a numbered decision record, in markdown.

  • agf spec

    Generates and validates specs from templates.

  • agf spec-sync

    Keeps living, versioned specs linked to the tasks in the graph.

  • agf out-of-scope

    Keeps ideas that were deliberately ruled out, so the same thing is not argued again.

  • agf ubiquitous-language

    Maintains the official domain vocabulary in its own section of CONTEXT.md.

  • agf changelog

    Generates changelog sections from the commit messages in a range.

  • agf manual

    Builds the technical manual as .docx from the files in docs/manual.

  • agf diagram

    Draws the flow diagram (architecture, steps or lifecycle) of the colony, an epic or the graph.

Integrations with your agent and tools

Connect agf to Claude Code, Copilot, Codex and other CLIs, and extend it with plugins.

  • agf hooks

    The points where agf acts on its own during the agent’s work: list, test and discover.

  • agf hooks install

    Installs agf’s hooks in Claude Code (session start, before and after each tool, on stop).

  • agf hooks list

    Lists the 28 hook points and the module responsible for each.

  • agf agent

    Creates and lists agent roles, both built-in and project-specific.

  • agf agent create

    Creates a new agent role in the project’s configuration file.

  • agf plugin

    Installs, removes, enables, disables, lists and shows plugins.

  • agf marketplace

    Adds git sources and lists the skills and plugins available in them.

  • agf mcp

    Checks how agf would connect to a remote MCP server and whether it needs login, without touching the network.

  • agf session

    Shows the current session data: identity, mode, model, run, permissions and events.

  • agf daemon

    Inspects and cleans up agf processes left running in the background.

  • agf skills

    Publishes the project skills to the public mirror.

Diagnostics, maintenance and internal tools

Save and restore states, repair the graph and reach the tools used to develop agf itself.

  • agf snapshot

    Creates, lists and restores backups of the task graph.

  • agf snapshot create

    Saves a copy of the current graph, internally or to a file.

  • agf workspace

    Takes snapshots of the project files’ state to compare, restore or revert.

  • agf heal

    Finds and fixes problems in the task graph on its own, saving the result.

  • agf gc

    Removes orphaned isolated project copies and ai-shadow/* branches.

  • agf web-parity

    Lists what the CLI does that the web dashboard does not show yet, by priority.

  • agf rules-filter

    Internal tool: filters a rules catalogue down to the ones for the project’s language.

  • agf hash-content

    Internal tool: computes a fingerprint of a TS/JS file that ignores comments and whitespace.

  • agf secret-patterns

    Internal tool: generates the file with the patterns used to detect secrets.

  • agf sentrux

    Bridge to Sentrux: quality scans and gates; requires a running Sentrux server.

  • agf wave12-5w2h

    Internal tool: prints the planning document for the isolated builds initiative (Wave 12).

  • agf signals

    Groups recorded failures by cause, one graph item per cause.

  • agf telemetry

    Optional telemetry: preview what would be sent, send it, configure it or turn it off.