Troubleshooting

Command cannot be found

Use the absolute executable path, especially for MCP clients: AGENT_EXEC="$(command -v agent-exec)".

Job is still running

Keep its job_id, then call agent-exec wait "$JOB_ID" with a suitable deadline. The observation deadline does not end the job.

Need more output

Call agent-exec tail "$JOB_ID". Responses include bounded excerpts and paths to retained logs.

Need diagnostics

Set RUST_LOG=debug; diagnostics go to stderr, preserving JSON-only stdout.