Configuration
August 29, 2026 ยท View on GitHub
Commands use an executor, optional prompt template, and timeout:
[commands.audit]
executor = "codex"
prompt_file = "prompts/audit.md"
timeout = "30m"
[commands.custom-workflow]
executor = "custom-workflow-script"
timeout = "2h"
Without prompt_file, the input prompt is sent unchanged. With a template, include
{{machinist.prompt}}. Executors and repositories remain worker-owned:
[executors.custom-workflow-script]
command = ["./scripts/custom-workflow.sh"]
[repositories.my-project]
path = "/absolute/path/to/my-project"
Managed triggers select one command with command = "audit". Model selection remains
available when the executor command includes {{machinist.model}}.
Migration
The agents table was renamed to commands. Move [agents.NAME] to [commands.NAME]
and replace --agent with --command.
The pipeline feature was removed. Replace a sequential pipeline with one executable script,
configure that script as an approved worker executor, and expose it through one command.
Legacy [pipelines] configuration fails with migration guidance. Pre-command databases are
recreated once because this release intentionally consolidates the schema before active use.