npm
npm install --global trycase trycase login No install Copy npx -y trycase@latest capabilities --pretty A complete verification flow Copy trycase doctor --pretty trycase repository show trycase pr show owner/repository#123 trycase verify run owner/repository#123 --prompt-file verification.md trycase verify follow <bot-id> trycase result list <bot-id> --pretty trycase artifact list <bot-id> --pretty Git-aware Infers owner/name from the current checkout when a repository is omitted. Live progress Follow status changes as NDJSON and act immediately when attention is required. Proof included List, view, and safely download screenshots and captioned demo videos. 02 / Authentication Browser login for people. Environment credentials for automation. trycase login uses device authorization and stores a 90-day grant with owner-only filesystem permissions. Use --no-open on a remote shell. Interactive Copy trycase login --no-open trycase whoami --pretty CI / automation Copy export TRYCASE_API_URL=https://api.trycase.dev export TRYCASE_TOKEN=<token> trycase whoami --pretty Tokens are never accepted as command-line arguments. Set TRYCASE_TOKEN and TRYCASE_API_URL together, and never print them in logs. 03 / Reference The complete command surface All examples begin with trycase . Add --pretty for readable JSON or --timeout 60 to change the HTTP timeout. Account & discovery Authenticate, inspect the local setup, and discover the live machine contract. Command Arguments Purpose login [--no-open] [--api-url <url>] Start browser device authorization. logout — Revoke the current grant and remove stored credentials. whoami — Return the authenticated account. doctor — Check configuration, API origin, and authentication. capabilities — Return the versioned command manifest. Repositories & pull requests Resolve connected GitHub targets. Repository arguments can be inferred from the checkout. Command Arguments Purpose repository list [--limit <1-100>] [--cursor <cursor>] List connected repositories. repository show [owner/repository] Inspect a repository by ID, slug, or URL. pr list [owner/repository] [--limit <1-100>] List pull requests for a repository. pr show <owner/repository#number> Inspect one pull request. Verification Start, observe, continue, stop, and archive verification agents. Command Arguments Purpose verify run <PR> [--prompt-file <path>] [--model <id>] Start a verification; supports --request-id. verify list [repository] [--limit <1-100>] List recent verification bots. verify status <bot-id> Read the latest state without waiting. verify wait <bot-id> [--wait-timeout <seconds>] Wait for terminal or attention state. verify follow <bot-id> [--wait-timeout <seconds>] Stream changed states as NDJSON. verify message <bot-id> (--message <text> | --message-file <path>) Continue the same bot with a follow-up. verify stop <bot-id> --yes Pause active work and preserve its history. verify archive <bot-id> --yes Archive a completed or stopped bot. Results & proof Inspect verdicts and retrieve screenshots or captioned demo videos. Command Arguments Purpose result list <bot-id> [--limit <1-100>] List saved findings and verdicts. result show <result-id> Read one complete result. artifact list <bot-id> [--limit <1-100>] List proof attached to a bot. artifact url <artifact-id> Create a viewable signed URL. artifact download <artifact-id> --output <path> [--force] Download proof to an explicit path. 04 / Workflow A reliable loop for humans and agents Reuse a matching bot when possible, stream useful progress, and distinguish provisional results from a terminal run. 01 Discover Run capabilities and doctor. Treat the live capabilities manifest as authoritative. 02 Resolve Inspect the repository, pull request, and existing verification bots before starting another. 03 Run Put substantial instructions in a file and retain the request ID for safe retries. 04 Follow Stream changes. A result is provisional while terminal is false or messages remain queued. 05 Respond If requiresAttention is true, surface attentionReason and actionUrl to the user. 06 Collect Report the target commit, final verdict, result IDs, and viewable artifact links. Idempotency: verify run and verify message accept --request-id . Reuse the same value after an ambiguous network failure to avoid duplicate work. 05 / Machine contract JSON by default. NDJSON while following. Normal commands write one versioned envelope to stdout. Errors write one envelope to stderr. verify follow emits changed-state events followed by a final result envelope. Success envelope Copy { "schemaVersion": 1, "ok": true, "command": "verify status", "data": { "botId": "...", "status": "running", "terminal": false, "requiresAttention": false } } Error envelope Copy { "schemaVersion": 1, "ok": false, "command": "verify status", "error": { "code": "NOT_FOUND", "message": "Verification not found", "httpStatus": 404 } } terminal true only when the current queue has finished or the bot is archived. requiresAttention signals that a person must complete the returned action. nextCursor is opaque; pass it back unchanged when requesting the next page. 06 / Agent skill Give your coding agent the operating playbook The TryCase skill teaches compatible coding agents to discover the live contract, avoid duplicate bots, handle authentication safely, follow work to a real terminal state, and return evidence. SKILL.md trycase-cli A portable Markdown skill with safety rules, command patterns, progress semantics, and completion criteria. View raw skill ↗ Install in this repository Copy mkdir -p .agents/skills/trycase-cli curl -fsSL https://www.trycase.dev/skills/trycase-cli/SKILL.md \ -o .agents/skills/trycase-cli/SKILL.md Agent conventions vary. .agents/skills is the portable project-local location; consult your agent’s documentation if it uses another discovery path. 07 / Safety Guardrails are part of the interface Explicit lifecycle changes Stopping and archiving require --yes. Resolve the exact bot before changing its state. Protected downloads Downloads require an explicit output path and refuse to overwrite unless --force is present. Bounded inputs Prompt and message files must be regular, non-symlink files no larger than 32 KiB. Use - for stdin. Safe network handling Redirects and credential-bearing URL authorities are rejected. Signed artifact query parameters are supported. 08 / Errors Stable exit codes for automation Branch on the process exit code, then parse the JSON error envelope for the stable code, redacted message, and optional HTTP status. Exit Meaning 0 Success 2 Invalid command or input 3 Missing or invalid configuration 4 Authentication or authorization failure 5 Resource not found 6 Conflict 7 TryCase API failure 8 Network error or wait timeout 9 Local filesystem error Ready to verify Connect a repository, then bring TryCase into your terminal. Connect repository Get the skill trycase Pricing FAQ Privacy Terms Contact ben@trycase.dev for help. I get back to you within 48 hours