Skip to main content

​
Usage

archal run <scenario> --harness <name>
archal run <scenario> --harness <path>
archal harness check <path>

​
Bundled harnesses

Archal ships a small set of bundled harnesses: 
react         Full ReAct agent — structured reasoning, error recovery
hardened      Security-hardened — investigation-before-action
zero-shot     Minimal prompting
naive         Baseline only
Use one with: 
archal run scenario.md --harness react --agent-model gemini-2.5-flash
If you use --harness openclaw, you must also provide an endpoint via --engine-endpoint.

​
Local harness paths

You can also point --harness at a local file or directory: 
archal run scenario.md --harness ./.archal/harness.ts
Before the first real run, check that Archal can boot the harness headlessly: 
archal harness check ./.archal/harness.ts
That command tells you whether the next missing layer is:
  • harness resolution
  • a runnable entrypoint
  • a headless boot issue
  • or a service bridge/runtime issue on the harness path
See Harness configuration for the manifest format, environment variables, model tuning, and transport options.
  • Harness configuration — full reference for manifests, system prompts, temperature, thinking, and more
  • archal demo — compare bundled harnesses on a scenario
  • archal run — run a scenario with a specific harness