Headless and CI

zidane run --json --prompt "Fix the failing test in src/limits.test.ts" > result.json
jq -r .finalText result.json

{"type":"turn","index":0,"turn":{"role":"assistant","content":[…]}}
{"type":"turn","index":1,"turn":{"role":"user","content":[…]}}
{"status":"completed","finalText":"…","turns":2,…}

name: zidane
on:
  workflow_dispatch:
    inputs:
      task:
        description: What the agent should do
        required: true

jobs:
  agent:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 22
      - run: npm install -g zidane-tui
      - name: Run the agent
        env:
          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
          TASK: ${{ inputs.task }}
        run: zidane run --json --prompt "$TASK" --model claude-sonnet-4-5 > result.json
      - name: Summary
        if: always()
        run: jq -r '.finalText // .error.message' result.json >> "$GITHUB_STEP_SUMMARY"
      - run: git diff --stat

echo "Add a /health route" | bun run headless --output-format stream-json --max-turns 30 --transcript run.jsonl
bun run headless print-tools --json     # the exact tool schema the agent sees

import { runHeadless } from 'zidane/headless'
import { local } from 'zidane/providers'

const result = await runHeadless({
  prompt: 'Add a /health route that returns 200.',
  provider: local({ baseURL: 'http://localhost:8000/v1', defaultModel: 'my-model' }),
  cwd: '/tmp/rollout-42',
  maxTurns: 30,
  timeoutMs: 600_000,
  onEvent: e => process.stderr.write(`${e.type}\n`),
})

console.log(result.status) // 'completed' | 'aborted' | 'error' | 'timeout'