Skip to content
Agentic Coding Toolkit

Config

Run act-config once per project to choose where ACT saves generated Specs and Work Items.

When to use it

Section titled “When to use it”

Use act-config when starting ACT in a project, when .act/config.yaml is missing, or when you need to change between local storage and GitHub storage.

act-create-spec and act-create-issues can invoke setup automatically if required config is missing, but running act-config up front makes the storage choice explicit.

Invoke it

Section titled “Invoke it”
Terminal window
/act-config

This will ask for your preferred storage location for Specs and Work Items, then create a .act/config.yaml file that might look like this:

workflow:
  backend: local


local:
  path: ai_specs

See Project Setup for storage modes, local path examples, and GitHub storage limits.

Review before continuing

Section titled “Review before continuing”

Check that .act/config.yaml matches where you want ACT to save generated docs and implementation tasks. Then continue with act-interview to get started with your first task.