AgentKit
ReferenceCLI commands
BetaYou are reading docs for the beta channel (2.4.1-beta.1) — updated automatically on every beta release.Switch to stable →

CLI commands

ak diagnostics export

Export a redacted diagnostics bundle

Runs ak doctor --json, redacts known secrets, email addresses, and local path prefixes, then emits a support bundle suitable for closed-beta issue attachments.

Who it's for: Closed beta pilots and maintainers sharing health evidence without raw local paths or credentials.

When to use it: Use before filing feedback that needs install, update, adapter, or registry diagnostics.

What changes on disk: Read-only. Writes the redacted bundle to stdout.

Usage

ak diagnostics export [flags]

Examples

ak diagnostics export --json > agentkit-diagnostics.json
ak diagnostics export --offline --json

Flags

FlagDescription
-h, --helphelp for export
--jsonEmit machine-readable JSON (implies --no-interactive)
--no-interactiveDisable interactive prompts (CI-safe)
--offlineSkip network-dependent doctor checks before export
-q, --quietSuppress non-error output on stderr
-V, --verboseExtra diagnostic output on stderr (loses to --quiet)
-y, --yesAssume yes for all prompts

Output modes

ModeBehavior
prettydefault on TTY (colors, ASCII markers)
plainauto when stdout piped or --no-interactive
json--json (single-object envelope, NDJSON-safe)

Exit codes

CodeMeaning
0success
1runtime error
2invalid flags
3user-cancel (SIGINT, prompt-cancel)
1doctor failed or the redacted payload could not be encoded
2invalid flags

On this page