# Dynobox

Overview of Dynobox, supported harnesses, config formats, observable assertions, and current local runner limits.

Canonical docs: https://docs.dynobox.xyz/
Source repository: https://github.com/dynobox/dynobox
CLI package: dynobox
SDK package: @dynobox/sdk
Install CLI: npm install -g dynobox

## Start Here

- [Dynobox Docs](https://docs.dynobox.xyz/)
- [Markdown overview](https://docs.dynobox.xyz/README.md)
- [Full documentation text](https://docs.dynobox.xyz/llms-full.txt)
- [Machine-readable docs index](https://docs.dynobox.xyz/docs-index.json)

## Documentation Pages

- [Getting Started](https://docs.dynobox.xyz/getting-started/): Install the Dynobox CLI, scaffold a first dyno, choose harnesses, run targets, and debug local agent evals.
  - Markdown: https://docs.dynobox.xyz/getting-started.md
  - Source: https://github.com/dynobox/dynobox/blob/main/docs/getting-started.md
- [Config Authoring](https://docs.dynobox.xyz/config-authoring/): Author JavaScript, TypeScript, and YAML dynos with @dynobox/sdk helpers, assertions, harness options, HTTP capture, and reusable scenarios.
  - Markdown: https://docs.dynobox.xyz/config-authoring.md
  - Source: https://github.com/dynobox/dynobox/blob/main/docs/config-authoring.md
- [CLI Reference](https://docs.dynobox.xyz/cli/): Reference for dynobox init and dynobox run commands, flags, output modes, JSON reports, exit codes, and harness requirements.
  - Markdown: https://docs.dynobox.xyz/cli.md
  - Source: https://github.com/dynobox/dynobox/blob/main/docs/cli.md
- [CI Integration](https://docs.dynobox.xyz/ci/): Run Dynobox in CI, use harness matrices, write NDJSON reports, upload artifacts, and parse summary records.
  - Markdown: https://docs.dynobox.xyz/ci.md
  - Source: https://github.com/dynobox/dynobox/blob/main/docs/ci.md

## Core Commands

- Install: `npm install -g dynobox`
- Create a starter dyno: `dynobox init`
- Run discovered dynos: `dynobox run`
- Run a target: `dynobox run [path]`
- Select a harness: `dynobox run --harness claude-code` or `dynobox run --harness codex`
- Emit machine-readable reports: `dynobox run --reporter json`

## Agent Retrieval Notes

- Prefer markdown URLs for ingestion when available.
- Use `/llms-full.txt` when a single fetch should include the full docs corpus.
- Use `/docs-index.json` to route questions by page title, topic, and heading.