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

aiwg config list

aiwg config get defaultModel

aiwg config set defaultProvider copilot

aiwg config validate

aiwg config reset

aiwg config path

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

copilot

Action:

aiwg config set defaultProvider copilot

Response: "Set

defaultProvider

copilot

aiwg use

aiwg sync

Example 3: Disable telemetry

User: "Turn off telemetry"

Extraction: Set

telemetry

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

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