config, auth, doctor

Managing settings, credentials, provider health, and diagnostics.

config, auth, and doctor

Manage project settings, provider credentials, and system diagnostics.

niki config

Initialize configuration or write a local JSON schema for editor tooling.

# Interactive configuration setup wizard
niki config init --interactive

# Write ./niki.schema.json and print its path
niki config schema

niki auth

niki auth stores, removes, and reports credentials in the OS keyring. Keyring values are not currently resolved into runtime provider clients, so use niki.toml or supported environment variables for live calls.

# Log in to a provider
niki auth login --provider anthropic

# Pipe API key via standard input (CI/CD safe)
echo "$MY_KEY" | niki auth login --provider openai --stdin

# Check authenticated provider status
niki auth status

# Log out and erase stored key
niki auth logout --provider anthropic

niki doctor

Runs comprehensive environment diagnostics to detect misconfigurations before running tasks.

# Run all diagnostic checks
niki doctor

# Check specific category
niki doctor --category sandbox
niki doctor --category providers

niki recommend

Selects model/provider pairings from static role recommendations. --project history can add an observed-spend section, but observed spend does not drive the selected pairings.

niki recommend --preference balanced
niki recommend --role planner --task "Migrate database schema"