Configuration
Configure the OpenSkill CLI
Config File
OpenSkill stores its configuration in a JSON file at:
Config path
~/.openskill/config.jsonThe config file is created automatically on first use. It tracks your repositories, settings, and preferences.
Config Options
| Option | Type | Description |
|---|---|---|
| defaultAgent | string | Default agent for installations |
| repos | array | Configured skill repositories |
| version | number | Config format version (for migrations) |
Environment Variables
| Variable | Description |
|---|---|
| OSK_HOME | Override the default config directory (~/.openskill) |
| OSK_DEFAULT_AGENT | Override the default agent setting |
Managing Config
Use the config command to view and modify settings:
terminal
# List all settings
$ osk config list
# Get a specific value
$ osk config get defaultAgent
# Set a value
$ osk config set defaultAgent claudeYou can also edit the config file directly at
~/.openskill/config.json. The config file uses version-based migrations, so the format may change between releases.