CLI Configuration
The CLI supports multiple projects and environments (sandbox/live), allowing you to manage several Ikawaari accounts from a single machine.
View Current Configuration
ikw config list
┌─────────┬─────────┬─────────────┬──────────────────────────────────┬──────────────────────────────────┐
│ project │ current │ environment │ sandboxBaseUrl │ liveBaseUrl │
├─────────┼─────────┼─────────────┼──────────────────────────────────┼──────────────────────────────────┤
│ default │ true │ sandbox │ http://localhost:5000 │ http://localhost:5000 │
└─────────┴─────────┴─────────────┴──────────────────────────────────┴──────────────────────────────────┘
Switch Environment
Toggle between sandbox and live:
# Switch to live
ikw config set environment live
# Switch back to sandbox
ikw config set environment sandbox
Manage Projects
Projects let you work with multiple Ikawaari accounts:
# Create and switch to a new project
ikw config set project my-client
# Switch back to default
ikw config set project default
Each project has its own sandbox and live credentials.
Set Base URL
Override the API base URL (useful for local development or self-hosted instances):
ikw config set base-url http://localhost:5000
Configuration File
The config file is stored at:
| OS | Path |
|---|---|
| Linux | ~/.config/ikw/config.json |
| macOS | ~/Library/Application Support/ikw/config.json |
| Windows | %APPDATA%\ikw\config.json |
Structure
{
"currentProject": "default",
"projects": {
"default": {
"currentEnvironment": "sandbox",
"environments": {
"sandbox": {
"baseUrl": "https://api.ikawaari.com",
"apiKey": "ik_test_..."
},
"live": {
"baseUrl": "https://api.ikawaari.com",
"apiKey": "ik_live_..."
}
}
}
}
}