Configuration

The CLI is intentionally light on config. There's one file, a handful of env vars, and a few default paths.

Config file

Created by noddle-deck login:

text

~/.noddle-deck/config

Contains api_url and token. Plain JSON, readable and editable by hand if you need to.

Environment variables

Variable	Effect
`NODDLE_DECK_API_URL`	Overrides the `api_url` from the config file
`NODDLE_DECK_TOKEN`	Overrides the `token` from the config file (useful in CI)
`NODDLE_DECK_CONFIG_DIR`	Move the config dir from `~/.noddle-deck` to somewhere else

Env vars always win over the config file.

Default paths

Path	What lives there
`~/.noddle-deck/config`	CLI config (token, api_url)
`~/.noddle-deck/installed.json`	Local registry of installed packs + versions
`~/.noddle-deck/prompts/`	Default output for `noddle-deck sync`
`~/.claude/skills/noddle-deck-*/`	Installed pack skills
`~/.claude/commands/noddle-deck-*/`	Installed pack commands

Token management

Create and revoke tokens at /settings under CLI tokens. Limits per tier:

Tier	Active tokens
FREE	1
PRO	3
TEAM	10

Revoking a token in the dashboard invalidates it immediately on the server. The local config file still holds the old value — running noddle-deck logout && noddle-deck login --token <new> is the clean fix.