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, , or

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