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 initSets agf up in your project: configures it, checks the environment and starts the web dashboard.
agf welcomeQuick orientation that spends no tokens: project numbers, the next task and the skills for each phase.
agf helpA friendly index of the commands, with an overview and first steps.
agf retrieve-commandDescribe what you want in plain language and get the exact agf command back.
agf referencePrints the agf reference guide (tools, skills, phases and gates), optionally filtered by phase.
agf doctorChecks whether your environment is ready to run agf and points out what is missing.
agf upgradeUpdates the agf binary to the latest published version.
agf configReads, changes or lists the project settings.
agf presetLists, shows and applies ready-made workflow presets, such as default or strict-tdd.
agf install-neuralInstalls the local model that enables meaning-based search (embeddings) in the project.
agf principlesShows the engineering principles that guide agf, grouped by theme.
agf recentLists the project folders you used recently.
Plan the work
Turn an idea into a task graph with acceptance criteria you can test.
agf import-prdImports a requirements document (.md, .txt, .pdf, .html) into the task graph, with acceptance criteria on each task.
agf generate-prdGenerates a requirements document with testable acceptance criteria; with --import it becomes a task graph right away.
agf genesisCreates a project from scratch: from idea to task graph and the first instructions for the agent, in one step.
agf nodeCreates, shows, changes, moves, clones and removes items in the task graph.
agf node addAdds a task, epic, risk or decision to the task graph.
agf edgeCreates, lists and removes links between items in the task graph.
agf edge addLinks two items, for example saying one task depends on another.
agf decomposeFinds tasks that are too big and suggests how to split them into small parts.
agf gapsPoints out what the plan is missing (criteria, tests, requirements without tasks) and the command to fix each one.
agf templateReusable task breakdown templates: list and apply.
agf template applyCreates tasks and links from a template, filling in the variables you pass.
agf sequencePuts the child tasks of an item in a queue, each depending on the previous one, by creation order.
agf acStrengthens weak acceptance criteria by rewriting them as Given-When-Then.
agf verify-acChecks whether existing code already meets a task’s criteria before you build it from scratch.
agf sprintPlans, reviews and runs the retrospective of a sprint, all recorded in the task graph.
agf sprint planRecords the sprint scope, linking it to each included task.
agf riskOrganizes open risks: promote, accept or close.
agf risk triageTriages open risks; by default it only shows what it would do.
agf questionRecords questions for a person to answer, and lists, answers or rejects the pending ones.
agf replan-analyzeChecks sprint health (tasks taking longer than expected, parents blocking children) and suggests a replan.
agf cycle-repairFinds circular dependencies between tasks and proposes how to break them; by default it only reports.
agf spec-triageLists requirements, interfaces and contracts in the graph that no task implements yet.
agf mrdSuggests graph items to merge, review or retire, using only data already stored.
agf import-graphMerges an exported JSON task graph into the project.
agf reclassify-structuralMarks items that are only organizing headings (like “Roadmap”) as not implementable.
agf backfill-provenanceFills in the missing source file on graph items by inheriting it from the closest parent.
agf migrate-acMigration 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 nextHands you the next unblocked task to work on, one at a time.
agf startStarts the next task in one step: picks it, gathers context and marks it in progress.
agf contextBuilds a compact summary of everything the agent needs to know about a task.
agf preflightBefore coding, checks git and the graph to see if someone already did or is doing the same work.
agf briefGenerates complete instructions for a task to hand to another agent to carry out.
agf node statusChanges a task’s status (for example, to in progress or done), following the allowed flow.
agf testRuns the tests affected by the current task, or others you choose.
agf lintRuns eslint on just the affected files or on the whole project.
agf checkChecks the task’s definition of done and whether it followed test-before-code.
agf doneCloses the task: checks the definition of done, runs tests, saves what was learned and suggests the next one.
agf submitTakes in the result from an agent that worked from instructions, validates it, tests it and closes the task.
agf commit-scopeCommits only the files declared on the task, without sweeping in other people’s changes.
agf implementerLets an external agent report that it started, progressed or finished a task, with validation.
agf roleRecords or shows which role (implementer, reviewer or validator) is assigned to a task.
agf artifactsStores and fetches structured subtask results, such as diffs, files, interfaces, decisions and notes.
agf releasePuts a task you started but never touched back in the queue; refuses if it already has commits.
agf waitWaits 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 dashboardOpens the local web dashboard with the task graph and the cost savings tab.
agf statsShows how many items and links the graph has, by type and status.
agf kanbanDraws the Kanban board: status columns, work-in-progress limit and flow metrics.
agf tuiOpens the interactive terminal interface, with the graph and token usage.
agf insightsGraph analytics without AI: delivery metrics, bottlenecks and phases.
agf forecastForecasts when the backlog will finish, simulating 10,000 scenarios from the real weekly pace.
agf leadtimeShows how long tasks take at each stage and which have been sitting the longest.
agf epicTracks each epic: tasks done, already on main and with proof that it works.
agf epic trackShows milestone progress: child tasks done, on main and with a passing proof.
agf okrOne line per epic: the objective, how much of the key results was reached and the status.
agf phaseShows the lifecycle phases and detects which one the project is in.
agf uiOpens a simple web progress page (graph, tokens and live logs) on the port you choose.
agf exportExports the task graph as JSON, CSV or a Mermaid diagram.
agf doraThe 5 DORA metrics (frequency, lead time, failure, restore, rework) and first-try success.
agf evmEarned value for an epic (CPI, SPI and forecast final cost) from the estimates.
agf flow-modelLittle's Law per flow stage and the predicted gain if you change the load.
agf overheadShows how much time goes to gates, evaluation and retries, per task or overall.
agf retroRound retrospective: the 3 biggest bottlenecks and how throughput and lead time changed.
agf inboxShows 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 certaintyAnswers “is it really done?” for a task, showing each piece of evidence behind the verdict.
agf gateRuns the gates that say whether the project can move to the next phase (analysis, design, review, deploy and others).
agf validateRuns read-only checks: acceptance criteria, readiness, done, integrity and flow.
agf harnessScores from 0 to 100 how ready the code is for agents to work on (types, tests, docs, naming).
agf ciRuns the continuous integration steps in order and stops at the first failure.
agf qualityQuality gate over src/: fails if tests and logs fall below 95%.
agf quality-policyQuality rules that block or just warn when a metric crosses its limit.
agf guardrailSaved quality checks that run before and after an action, failing open or closed.
agf scanGathers into one list the problems found by quality score, types, security and tainted-data analysis.
agf tdd-scoreGives a 0 to 100 score for the quality of a task’s tests.
agf lint-filesFails if any source file goes over 800 lines.
agf scan-silent-failuresSearches the code for shortcuts that hide errors, such as empty catch blocks or “|| []”.
agf wire-checkFlags code paths that only run with mock data and that no real code turns on.
agf wire-dormantLists features that are built but not connected to anything and creates tasks to connect them; by default it only shows.
agf suiteWhen the full test suite is red, organizes the failures into tasks.
agf suite triageCreates one task per broken test file, without duplicating those already open.
agf evalRuns real scenarios and produces a scorecard: success rate, cost per success, tokens and time.
agf datasetStores evaluation datasets, created by hand or from real runs and decisions.
agf scenarioRuns agf’s self-check, which tests its own code with mutations and properties on a real in-memory database.
agf provenanceRanks each claim by how well it is backed: claimed, cited, validated or proven.
agf provenance promoteMoves a task up a proof level, only if the required evidence exists in the graph.
agf estimate-defectsEstimates how many defects are still undiscovered by comparing what two independent reviews found.
agf lifecycleRuns every analysis for one lifecycle phase and combines them into one report.
agf immuneLooks for error patterns in the code and runs a detect-and-recover cycle, keeping a history.
agf canaryCanary tasks whose criteria are locked to a test, to check agents do not cheat.
agf candidatesRuns the same task several times in separate folders and keeps the one that passed the tests.
agf claim-checkChecks what the agent claims it did against the real files and tests.
agf proofSuggests the usage proof that tells the code before and after the task apart.
agf judgeA panel of judges that grade the delivery: brief, votes, status and calibration.
agf andonStops 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 guardClassifies a command, path or address as allowed, ask first or denied.
agf guard checkChecks a command before it runs and returns an error when it should be blocked.
agf permissionsSets per project which actions and resources are allowed, denied or need asking.
agf approvalCreates, grants, verifies and revokes authorizations for actions that need approval.
agf approval waitWaits for a person to approve the task (through a signal file) before continuing.
agf auditLooks up the history of tools the agents called.
agf sandboxDetects the project stack (npm, maven, gradle, go, pip) and runs builds isolated from the rest of the system.
agf sandbox runRuns any agent CLI inside a container, with no network and only the declared variables.
agf exec-policyChecks whether a shell command can run directly, needs approval or is forbidden.
agf sandbox-gateChecks whether a command follows the file and network access rules.
agf envShows environment variables filtered by prefix, hiding secrets.
agf scan-binariesWrites the trust record for a release: hash, signature and VirusTotal result.
agf approveApproves a run that stopped waiting for a person and resumes where it left off.
agf rejectDenies 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 colonyViews for whoever leads the colony: what was delivered, what is in progress, blocked or in the backlog.
agf colony reportShows colony status: delivered, in progress, blocked, priorities and backlog.
agf colony bootstrapOpens the colony from the backlog: creates the isolated project copies and the commands for each session.
agf colony roundAutomatic round: refills work, lists idle agents and what is ready to merge into main.
agf colony standupStandup 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 reviewLists merges into main made by worker agents and merges with no identity.
agf antCreates, lists and removes each agent’s isolated copy of the project, all sharing one task graph.
agf ant spawnCreates (or reuses) an agent’s isolated copy of the project and returns the ready-made variables.
agf ant mergeMerges an agent’s work into main in one call, running types, tests and lint on the touched files.
agf ant gcRemoves agents’ isolated copies and branches already merged into main; by default it only shows.
agf assignAssigns a task to an agent; that agent’s agf next then hands it this task first.
agf claimsShows which agents are holding which tasks right now.
agf bottlenecksPoints out colony bottlenecks (overloaded machine, stalled tasks, idle agents) with the owner and the command to fix them.
agf colony-healthShows colony health and its measurement history.
agf casteLists the colony’s agent types and, for each, the model tier, maximum complexity and task types.
agf swarmOptional coordination between agents: sessions, resource reservations, messages and voting.
agf swarm agentsShows each agent’s live status: heartbeat, locks and current task.
agf batch-selectGroups up to N small, unblocked tasks to hand out in one round (read-only).
agf adoptTakes over the tasks of agents that are no longer running, recording who took them.
agf freezeFreezes the colony on an epic: agents only get its tasks until you release it.
agf signalSends a message to another agent (or all of them) through the graph, including a stop request.
agf missionTakes 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 autopilotWorks through tasks on its own, one at a time: picks, builds, checks the definition of done and closes or asks for help.
agf deliverFrom request to delivery: turns text, a file or an image into requirements, a task graph and tested code.
agf buildDrives the whole delivery: requirements, graph, task breakdown, autopilot and delivery.
agf runImplements a one-off request in a single run: generates the code, applies it and tests it (via the Copilot SDK).
agf loopRuns an agf command on an interval, or repeats until a success rubric passes.
agf loop startStarts a loop in the background, without holding the terminal.
agf execRuns several agf commands in sequence.
agf pipelineCompound commands that do several operations at once, opening the graph only once (faster).
agf checkpointRuns work in steps and resumes from the last finished step; a step can wait for approval.
agf checkpoint-scheduleSchedules step-by-step runs on a timetable (cron).
agf scheduleSchedules prompts to the agent on a timetable (cron).
agf webhookStarts step-by-step runs when a signed HTTP call arrives.
agf longrunKeeps an eye on long runs: status, heartbeat and daily report.
agf automateProposes, adopts and reviews automations by comparing before and after.
agf slotA 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 providerChooses and shows the model provider (Copilot by default, or OpenAI-compatible services).
agf provider useSets the project’s active provider, including the address of a local or remote server.
agf modelChooses or shows the model; with auto, agf picks a suitable model for each task.
agf statusOne panel: provider, model, cache, tokens, dollars spent and savings.
agf savingsRunning table of input, output and cache tokens and cost saved.
agf metricsShows how many tokens each task and session used in automatic mode.
agf economyTurns on, turns off and lists the optional token-saving techniques.
agf economy listLists each saving technique, whether it is on and how many tokens it has saved.
agf compressShortens tool output before the agent reads it, with filters per command type.
agf compress runRuns a command and returns its output already compressed (or compresses what comes from stdin).
agf cacheShows prompt cache statistics.
agf retrieveGets back the original text that was compressed, using the code left in its place.
agf recallPrints a stored full output byte for byte, by its code.
agf loginConnects your GitHub Copilot account for agf to use as a provider.
agf logoutRemoves the saved GitHub Copilot access.
agf gearshiftManually picks a gear from 1 to 4 for model and effort, reflected in the Claude Code settings.
agf profileReady-made work bundles that combine model tier, flow and number of retries.
agf flowTurns on, turns off and shows flow, a formula that reduces the context sent to the model.
agf calibrateSuggests, from savings already measured, the confidence level at which context retrieval pays off.
agf ponytailShows or changes the ponytail level (the mode that asks agents for the simplest solution) and where the value came from.
agf codemodeThe agent writes a small program that calls the tools instead of calling them one by one, spending fewer tokens.
agf proxyA local OpenAI-compatible proxy that applies agf savings and records every call.
agf discoverShows the command outputs that still reach the agent unfiltered, so you know what to compress.
agf captureDecides how much of a tool output to keep (nothing, a reference or all of it) to look up later.
agf export-datasetExports 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 memoryWrites, reads, lists, searches and deletes project memories.
agf memory writeSaves a memory, from inline text or from a file.
agf skillLists and shows skills, which are ready-made instructions for agents.
agf skill listLists the skills available in the project and in your CLI.
agf learningStored learning: each agent’s performance, agent choice and export.
agf learning routeSuggests which agent should take the task, based on history.
agf learnReads a Claude session, finds where a command failed and then worked, and lists the correction rules.
agf learn-evalMeasures how often the automatic learning gets its choices right.
agf dreamKnowledge consolidation cycles inspired by sleep: start, status, history and cancel.
agf knowledge-compileTurns a knowledge text into a structured page, with links and a version.
agf knowledge-learnBrings in memories, decisions and patterns from another project’s graph.
agf knowledge-lintChecks the stored knowledge and points out problems, without deleting anything.
agf federationShares knowledge across projects: registers other projects and pulls in what they learned.
agf prediction-feedbackStores wrong predictions and their corrections so the agent can check them before repeating a mistake.
agf traceKeeps execution records, with the steps and the cost and time of each.
agf usageTracks which commands you use most, shows trends and generates automatic shortcuts.
agf remTidies memory: merges near-duplicate memories and archives unused ones, without deleting anything.
agf kbKnowledge base: search and read; proposes and confirms new items but never publishes on its own.
agf harvestWhen 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 searchSearches the text of task graph items, ranking the most relevant first.
agf queryFilters graph items by type, status, parent or text.
agf codeCode intelligence: index, search, navigate and measure the impact of a change.
agf code indexIndexes the project code (functions, classes and who calls whom).
agf code skeletonShows only a file’s signatures, without function bodies: about 10 times smaller than reading it.
agf code impactShows what may break if a file changes.
agf readReads a source file; in aggressive mode it shows only the signatures.
agf smartSummarizes a source file in 2 lines, without using AI.
agf diffCompares two files and shows the difference compactly.
agf logShows a log without repeats: identical lines become one with a count.
agf errRuns a command and shows only its errors.
agf depsSummarizes the project dependencies per manifest file, without running the package manager.
agf lspShows the status of the configured language servers.
agf docsStores and searches library documentation, and generates living docs from the graph.
agf docs generateGenerates agent-oriented documentation from the graph, without spending tokens.
agf web-searchSearches the web via Exa or Tavily, without duplicates and ranked by relevance.
agf parse-apiReads an OpenAPI or WSDL spec and extracts the endpoints and data shapes.
agf scaffoldGenerates ready code skeletons (class, function, component) for a task, without AI by default.
agf montar-outputInternal tool: for a goal, finds a ready output skeleton and fills in the blanks, or generates a new one.
agf scan-reposExamines 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 constitutionManages the project principles and checks whether the work follows them.
agf adrArchitecture decision records: create and list.
agf adr createCreates a numbered decision record, in markdown.
agf specGenerates and validates specs from templates.
agf spec-syncKeeps living, versioned specs linked to the tasks in the graph.
agf out-of-scopeKeeps ideas that were deliberately ruled out, so the same thing is not argued again.
agf ubiquitous-languageMaintains the official domain vocabulary in its own section of CONTEXT.md.
agf changelogGenerates changelog sections from the commit messages in a range.
agf manualBuilds the technical manual as .docx from the files in docs/manual.
agf diagramDraws 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 hooksThe points where agf acts on its own during the agent’s work: list, test and discover.
agf hooks installInstalls agf’s hooks in Claude Code (session start, before and after each tool, on stop).
agf hooks listLists the 28 hook points and the module responsible for each.
agf agentCreates and lists agent roles, both built-in and project-specific.
agf agent createCreates a new agent role in the project’s configuration file.
agf pluginInstalls, removes, enables, disables, lists and shows plugins.
agf marketplaceAdds git sources and lists the skills and plugins available in them.
agf mcpChecks how agf would connect to a remote MCP server and whether it needs login, without touching the network.
agf sessionShows the current session data: identity, mode, model, run, permissions and events.
agf daemonInspects and cleans up agf processes left running in the background.
agf skillsPublishes 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 snapshotCreates, lists and restores backups of the task graph.
agf snapshot createSaves a copy of the current graph, internally or to a file.
agf workspaceTakes snapshots of the project files’ state to compare, restore or revert.
agf healFinds and fixes problems in the task graph on its own, saving the result.
agf gcRemoves orphaned isolated project copies and ai-shadow/* branches.
agf web-parityLists what the CLI does that the web dashboard does not show yet, by priority.
agf rules-filterInternal tool: filters a rules catalogue down to the ones for the project’s language.
agf hash-contentInternal tool: computes a fingerprint of a TS/JS file that ignores comments and whitespace.
agf secret-patternsInternal tool: generates the file with the patterns used to detect secrets.
agf sentruxBridge to Sentrux: quality scans and gates; requires a running Sentrux server.
agf wave12-5w2hInternal tool: prints the planning document for the isolated builds initiative (Wave 12).
agf signalsGroups recorded failures by cause, one graph item per cause.
agf telemetryOptional telemetry: preview what would be sent, send it, configure it or turn it off.