14  CLI Reference

14.1 tactus run

Execute a procedure:

tactus run procedure.tac

# Shortcut (auto-inserts "run" if the first arg is a file)
tactus procedure.tac

# Pass inputs
tactus run procedure.tac --param name="Alice"
tactus run procedure.tac --param count=5 --param enabled=true
tactus run procedure.tac --param items='[1,2,3]'
tactus run procedure.tac --param config='{"key":"value"}'

# Prompt for all inputs
tactus run procedure.tac --interactive

# Mocking (for fast, offline runs)
tactus run procedure.tac --mock-all
tactus run procedure.tac --mock search --mock api_call
tactus run procedure.tac --mock-all --real done

# Sandbox controls
tactus run procedure.tac --sandbox
tactus run procedure.tac --no-sandbox

14.2 tactus validate

Validate a .tac or .lua file:

tactus validate procedure.tac
tactus validate procedure.tac --quick

14.3 tactus info

Show extracted metadata (inputs, outputs, agents, tools, scenarios):

tactus info procedure.tac

14.4 tactus test

Run in-file Specifications([[ ... ]]) scenarios:

tactus test procedure.tac
tactus test procedure.tac --scenario "Agent completes research"
tactus test procedure.tac --runs 10          # consistency check
tactus test procedure.tac --mock             # mocked tools (deterministic)
tactus test procedure.tac --mock-config mocks.json
tactus test procedure.tac --param topic="AI"

14.5 tactus eval

Run Evaluations({ ... }) (Pydantic Evals integration):

tactus eval procedure.tac
tactus eval procedure.tac --runs 10

14.6 tactus train

Train a model declared in a .tac file. Training configuration lives inside the Model block under training = { ... }.

# Install ML extras if needed
pip install tactus[ml]

# Train the model and register artifacts
tactus train file.tac --model imdb_nb

If a file declares multiple models, --model is required.

14.7 tactus models evaluate

Evaluate a registered model version against the Model’s training.data.test split.

tactus models evaluate file.tac --model imdb_nb
tactus models evaluate file.tac --model imdb_nb --candidate nb-tfidf

14.8 Tracing

tactus trace-list
tactus trace-show <run-id>
tactus trace-show <run-id> --checkpoint 12
tactus trace-export <run-id> trace.json

14.9 Sandbox Image

tactus sandbox status
tactus sandbox rebuild --force

14.10 tactus ide

tactus ide
tactus ide --port 5001
tactus ide --no-browser