Skip to content

docs: add AGENTS.md for non-interactive / agent usage#110

Open
crowlbot wants to merge 3 commits into
mainfrom
docs/agents-md
Open

docs: add AGENTS.md for non-interactive / agent usage#110
crowlbot wants to merge 3 commits into
mainfrom
docs/agents-md

Conversation

@crowlbot

Copy link
Copy Markdown
Contributor

Adds an AGENTS.md documenting how to drive the CLI non-interactively from an AI agent or CI job.

Covers:

  • Token auth via DENO_DEPLOY_TOKEN (no browser), and whoami for a side-effect-free auth check
  • --non-interactive / -y behavior and the env vars that back each prompted value
  • --json structured output and the structured error envelope
  • The exit-code taxonomy (0 OK / 1 GENERIC / 2 USAGE / 3 AUTH / 4 NOT_FOUND / 5 CONFLICT / 6 NETWORK)
  • Global + per-subcommand flag reference
  • 5 copy-pasteable example flows (auth check, create + deploy, prod deploy, env vars, list deployments)
  • Idempotency / CONFLICT semantics

All flag names, env vars, exit codes, and JSON shapes were taken from the current source (config.ts, util.ts, auth.ts, deploy/*).

@crowlbot crowlbot requested a review from crowlKats June 25, 2026 19:17
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

1 participant