Use these commands to bootstrap setup, validate resolved runtime config, and safely edit configuration. For the full settings reference see Configuration Reference.
Quick command map
- First run
- Inspect config
- Edit & verify
notewise setup
Run the interactive setup wizard. Prompts for your LLM provider and API key, then writes ~/.notewise/config.env.
| Option | Description |
|---|---|
--force / -f | Re-run wizard even when config already exists |
--show | Display current config and exit |
notewise config
Show the fully resolved runtime configuration. API keys are masked.
notewise config-path
Print the config file path and whether it exists.
notewise edit-config
Open config.env in your $EDITOR. On Windows, Notepad is used when EDITOR is not set.
Key files
| File | Purpose |
|---|---|
~/.notewise/config.env | Primary config file |
~/.notewise/.notewise_cache.db | SQLite cache |
~/.notewise/logs/ | Session log files |
Common setup issues
setup says config already exists
setup says config already exists
Re-run with force:
Need to verify which config file is active
Need to verify which config file is active
NOTEWISE_HOME is set, notewise resolves config from that directory.API key looks set but calls still fail
API key looks set but calls still fail
Confirm model/key pairing in resolved config:Verify
DEFAULT_MODEL and the matching provider API key are both present.