kagi-account-config

name	kagi-account-config
description	Configure Kagi CLI credentials, profiles, lenses, custom bangs, redirects, site preferences, and account-backed assistants. Use when the user wants to inspect or change how Kagi authenticates, searches, or applies account settings.
allowed-tools	Bash(kagi:*)

Kagi Account Configuration

Inspect current state before changing it. Never print, echo, or paste stored credential values into output.

Credential model

Credential	Main capabilities
KAGI_SESSION_TOKEN	subscriber search, Quick Answer, Assistant, ask-page, translation, subscriber summarization
KAGI_API_KEY	current Search API and Extract API
KAGI_API_TOKEN	legacy summarize, FastGPT, and Enrichment APIs

Environment variables override .kagi.toml. --profile NAME selects a named profile. Base search prefers session auth when both search credentials are available, unless preferred_auth = "api" is configured.

Inspect and verify auth

kagi auth status
kagi auth check
kagi usage --format pretty

Use status to see credential presence and source. Use check when a configured credential fails at request time.

Use the auth wizard or explicit auth subcommands to set credentials:

kagi auth
kagi auth set --session-token "https://kagi.com/search?token=..."

Never pass secrets on a shared shell command line. Prefer the interactive wizard or protected environment injection in shared environments.

Profiles

Use profiles when separate accounts or credential policies must coexist.

kagi --profile work auth status
kagi --profile personal search "query" --format toon

Verify the selected profile before changing any setting.

Search settings

Inspect before creating, updating, or deleting:

kagi lens list
kagi lens get "Default"
kagi bang custom list
kagi redirect list
kagi site-pref list

Example custom bang:

kagi bang custom create \
  "Docs" \
  --trigger docs \
  --template "https://docs.rs/releases/search?query=%s"

Use each command's --help for the flags a mutation needs. Never delete or overwrite an account setting unless the user asked for it.

Custom assistants

kagi assistant custom list
kagi assistant custom get "Researcher"

Conversation and thread use belongs in kagi-assistant. This skill owns the account-level configuration of custom assistants.

Completion criteria

Configuration work is complete when:

• you know the active profile and credential source;
• the requested setting is visible through its read command;
• no secret value appears in output or persisted scripts;
• unrelated account settings remain unchanged; and
• you made a destructive change only when the user asked for it.