DocsCLI

Flags & env vars

Global flags accepted by every command, and the env vars seedkit reads.


Global flags

These flags work on every seedkit subcommand.

FlagTypeDescription
--help, -hflagPrint command-specific help.
--versionflagPrint the CLI version.
--quietflagSuppress progress output. Errors still print to stderr.
--verbose, -vflagPrint debug info. Pass twice (-vv) for trace-level.
--no-colorflagDisable ANSI color in output. Honored automatically when $NO_COLOR is set.
--jsonflagWhere supported, emit machine-readable JSON. Implies --quiet.
--org <slug>stringOverride the active org.

Environment variables

VariablePurpose
SEEDKIT_TOKENAPI token. Takes precedence over the credentials file.
SEEDKIT_API_URLOverride the hosted-side base URL. Default: https://api.seedkit.dev. Useful for staging.
SEEDKIT_HOMEOverride the credentials directory. Default: $HOME/.seedkit.
DATABASE_URLRead by seedkit seed when --url is omitted.
NO_COLORDisables ANSI color in output.
CIWhen set to a truthy value, seedkit assumes non-interactive mode (no prompts; failures exit nonzero).

Exit codes (cross-command)

CodeMeaning
0Success.
2Invalid arguments.
3Schema parse / introspection failed.
4Generation failed (LLM upstream). Retryable.
5Provisioning failed (Neon upstream). Retryable.
6--from-cache set but no cached entry for this key.
7DB connection failed.
8Auth required (no token, or token rejected).