/config

namespace: aiwg
name: config
platforms: [all]
description: Manage the user-level AIWG configuration file for persistent preferences across all projects

Config

You manage the user-level AIWG configuration file. This is the persistent preferences store that applies across all projects: default provider, default model, telemetry opt-in/out, and other global settings.

Triggers

Alternate expressions and non-obvious activations (primary phrases are matched automatically from the skill description):

• "what's my default provider" → get subcommand for `provider`
• "turn off telemetry" → set subcommand for `telemetry`
• "where is the aiwg config file" → path subcommand
• "reset aiwg to defaults" → reset subcommand
• "open config in my editor" → edit subcommand
• "is my config valid" → validate subcommand

Trigger Patterns Reference

| Pattern | Example | Action | |---------|---------|--------| | List all settings | "show my aiwg config" | Run `aiwg config list` | | Read a value | "what's my default model?" | Run `aiwg config get defaultModel` | | Write a value | "set default provider to copilot" | Run `aiwg config set defaultProvider copilot` | | Validate | "check my config for errors" | Run `aiwg config validate` | | Reset | "reset config to defaults" | Run `aiwg config reset` | | Locate file | "where is the config file?" | Run `aiwg config path` | | Open editor | "edit config" | Run `aiwg config edit` |

Behavior

When triggered:

1. **Extract intent**:

• Which subcommand: `list`, `get`, `set`, `validate`, `reset`, `path`, or `edit`?
• For `get`/`set`: what is the key? For `set`: what is the new value?
• Is a custom config directory specified via `--config-dir`?

2. **Resolve config directory** (in order): 1. `AIWG_CONFIG` environment variable 2. `--config-dir <path>` flag 3. `~/.aiwg/config.json` 4. `~/.config/aiwg/config.json`

3. **Run the appropriate command**:

   # Show all configuration values
   aiwg config list

   # Read a specific key
   aiwg config get <key>

   # Write a value
   aiwg config set <key> <value>

   # Validate the config file
   aiwg config validate

   # Reset to factory defaults
   aiwg config reset

   # Show resolved config file path
   aiwg config path

   # Open in $EDITOR
   aiwg config edit

   # Use a custom config directory
   aiwg config list --config-dir /path/to/config

4. **Common configuration keys**:

| Key | Type | Description | |-----|------|-------------| | `defaultProvider` | string | Active provider (e.g., `claude-code`, `copilot`) | | `defaultModel` | string | Model override (e.g., `claude-opus-4-5`) | | `telemetry` | boolean | Usage telemetry opt-in | | `updateChannel` | string | `stable`, `next`, or `nightly` | | `configDir` | string | Custom config directory path |

5. **Report results** — For `list`/`get`, display the value(s). For `set`, confirm what changed. For `validate`, show any errors found. For `reset`, warn the user that this is destructive and confirm before proceeding.

Examples

Example 1: Show all settings

**User**: "Show me my AIWG configuration"

**Extraction**: List all settings

**Action**:

aiwg config list

**Response**: Displays all keys and their current values, e.g.:

defaultProvider  claude-code
defaultModel     (not set — using platform default)
telemetry        true
updateChannel    stable

---

Example 2: Change default provider

**User**: "Set my default provider to GitHub Copilot"

**Extraction**: Set `defaultProvider` to `copilot`

**Action**:

aiwg config set defaultProvider copilot

**Response**: "Set `defaultProvider` to `copilot`. This will be used as the default for `aiwg use` and `aiwg sync` going forward."

---

Example 3: Disable telemetry

**User**: "Turn off telemetry"

**Extraction**: Set `telemetry` to `false`

**Action**:

aiwg config set telemetry false

**Response**: "Telemetry disabled. AIWG will no longer send usage data."

---

Example 4: Locate config file

**User**: "Where does AIWG store its config?"

**Extraction**: Path lookup

**Action**:

aiwg config path

**Response**: "Config file: `~/.aiwg/config.json` (exists)"

---

Example 5: Validate after manual edit

**User**: "I edited the config manually — check if it's valid"

**Extraction**: Validate request

**Action**:

aiwg config validate

**Response**: "Config valid. No errors found." — or lists specific schema errors if invalid.

---

Example 6: Custom config directory

**User**: "Check config using the team shared config dir at /opt/aiwg-team"

**Extraction**: List with `--config-dir`

**Action**:

aiwg config list --config-dir /opt/aiwg-team

**Response**: Displays config values loaded from `/opt/aiwg-team/config.json`.

Clarification Prompts

If the user's intent is ambiguous:

• "Which config key are you asking about? (run `aiwg config list` to see all keys)"
• "What value should I set `<key>` to?"
• "`aiwg config reset` will overwrite all settings with factory defaults. Proceed?"

References

• @$AIWG_ROOT/src/cli/handlers/subcommands.ts — Config command handler
• @$AIWG_ROOT/docs/cli-reference.md — CLI reference