All docs

CLI

Run many calls: cady local batch

cady local batch runs a file of calls, one per line, and stops after the first one that fails.

The CLI is not released yet; see Install the CLI.

Each line of the file is one call:

{"tool": "cady_read", "arguments": {"refs": ["company:setup"]}}
{"tool": "work_read", "arguments": {}}
cady --company COMPANY_UUID local batch --input calls.jsonl

It prints one JSON line per call, with its position and a status:

{"index": 0, "status": "success", "result": {...}}
{"index": 1, "status": "refused", "result": {...}}

The statuses are success, refused, uncertain and not_attempted. Every line is validated before the first call is sent.

Limits

  • At most 1,000 calls and 2 MiB per file.
  • --concurrency sets how many run at once, from 1 to 8. The default is 1.
  • There is no transaction across calls, no automatic approval and no automatic retry.

What can go wrong

  • A call was refused, so later calls were not attempted. Fix the cause and run the remaining lines.
  • A call is uncertain. Read the record it would have changed before running it again.
  • A line is invalid, or two lines name different companies. Nothing was sent.
  • The exit code tells these apart: see Troubleshooting and help.

For agents: this page as Markdown.