You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Error catalogue: every error apic prints, its exit code and the fix #65
apic's errors are already good ("it is captured by request login; run apic run login first"). A single page that lists every one, with the exit code and what to do, is what the FAQ, the agent guide and the VS Code extension's quick fixes all want to link to, and it is the page search engines land people on.
What
Give every user-facing error a stable code (E101 missing variable, E201 unknown request, E301 transport, …) carried on the error type in internal/runner/errors.go and surfaced in --json as "error": {"code", "message", "hint"} (additive to the current shape; README contract note).
docs/errors.md generated by task docs:errors from a table in the code (code, exit status, message template, hint, longer explanation), so it cannot drift; CI staleness check like the other generated docs.
Each printed error ends with the short URL of its entry when stderr is a terminal (see https://datagriff.github.io/api-caller/errors/#e101), and apic validate diagnostics carry the same codes.
The FAQ links each answer to its code; docs/agents.md tells agents to read error.code.
Activity
Error catalogue: stable codes, --json error object, generated docs/er…
dataGriff commentedon Sep 24, 2026
Done in #116 (commit da5ffc5).
runner.Catalogue. E1xx is the request, E2xx the command and project, E3xx the network.--json: the error is written to stderr as{"error": {code, title, message, hint, exit, url}}. Arunresult carries the same object aserror.docs/errors.mdis generated bytask docs:errors, with a staleness test.TestEveryCodeIsProducedruns a real command for every code in the catalogue.bad-ref,unknown-selector, …), listed on the same page.Generated by Claude Code