Utility Commands

Beyond running agentic workflows, agac provides commands for project setup, debugging, and maintenance. These utilities help you initialize projects, debug template rendering, run tests, and keep your workspace clean.

render / compile (removed)

agac render and agac compile are no longer available as standalone commands. Rendering happens implicitly during preflight — when agac inspect loads a workflow it Jinja2-expands templates, resolves prompts, inlines schemas, and expands versions. A rendering failure surfaces a non-zero exit and writes the partial YAML to .agent-actions/cache/rendered_workflows/<workflow>_failed.yml for debugging.

If you need fresh scaffolding (the prior --create-dirs use case), use agac init.

init

Starting a new Agent Actions project from scratch? The init command creates a well-organized directory structure with all the standard folders you'll need.

bash

BASH

agac init <project-name> [options]
agac init list
agac init example <name> [project-name]

This creates:

text

TXT

my-project/
├── agent_actions.yml      # Project configuration (required marker file)
├── agent_workflow/        # Agentic workflow definitions
├── schema/                # JSON schemas for validation
├── prompt_store/          # Prompt templates
└── tools/                 # Custom tools

Think of this like npm init or git init - it gives you a working starting point with sensible defaults.

Subcommands:

Subcommand	Description
list	List available example projects from GitHub
example <name> [project-name]	Scaffold from a GitHub example

Options (for agac init <project-name>):

Option	Description
-o, --output-dir	Directory to create the project in (default: current directory)
-t, --template	Template to use for project initialization (default: default)
-f, --force	Force project creation even if directory exists

Examples:

bash

BASH

# Create a new project in the current directory
agac init my_project

# Create a project in a specific directory
agac init my_project -o ~/projects

# Use a specific template
agac init my_project -t minimal

# See all available examples
agac init list

# Scaffold from a GitHub example
agac init example contract_reviewer

# Scaffold from an example with a custom project name
agac init example contract_reviewer my_project

# Force overwrite existing files
agac init my_project -f

:::tip Start from an Example Use agac init list to see available examples, then agac init example <name> to scaffold a fully working project you can run immediately. Examples are fetched from GitHub so the package stays lightweight. :::

clean

Over time, your project accumulates cached results, generated documentation, and temporary files. The clean command removes these artifacts and returns your project to a fresh state.

bash

BASH

agac clean -a <workflow-name> [options]

Removes:

• Cached batch results
• Generated documentation
• Temporary files
• Build artifacts

Options:

Option	Description
-a, --agent TEXT	Agentic workflow name (required)
-f, --force	Skip interactive confirmation
--all	Remove all directories including staging (default removes source and target only)

Examples:

bash

BASH

# Clean artifacts for a specific workflow (with confirmation)
agac clean -a my_workflow

# Force clean without confirmation
agac clean -a my_workflow -f

# Remove all directories including staging and target
agac clean -a my_workflow --all

:::tip Run from Anywhere You can run this command from any subdirectory within your project. :::

:::warning Data Loss This removes cached batch results. If you haven't retrieved batch results yet, do that first before cleaning. :::

docs

Build and serve interactive documentation for your agentic workflows. The docs command scans your project, generates documentation data, and starts an HTTP server in one step.

bash

BASH

agac docs [options]

Options:

Option	Description
-o, --output	Output directory for generated files (default: artefact)
-p, --port	Port to run server on (default: 8000)

Examples:

bash

BASH

# Build and serve documentation on default port
agac docs

# Serve on a custom port
agac docs --port 3000

# Generate to a custom directory
agac docs --output ./custom-artefact

docs test

Run Playwright tests to verify the documentation site renders correctly.

bash

BASH

agac docs test [options]

:::tip Run from Anywhere You can run docs commands from any subdirectory within your project. :::

status

Check the execution status of a specific agentic workflow. This shows which actions are running, completed, or failed.

bash

BASH

agac status -a <workflow-name> [options]

Options:

Option	Description
-a, --agent TEXT	Agentic workflow name (required)

Example:

bash

BASH

agac status -a my_workflow

:::tip Run from Anywhere You can run this command from any subdirectory within your project. :::

See Also

• run Command - Execute agentic workflows
• batch Commands - Manage batch processing
• schema Command - Analyze agentic workflow structure