Skip to main content

/config Command

View or set AIKit configuration settings.

Usage

# View all configuration
/config

# Get specific value
/config get <key>

# Set specific value
/config set <key> <value>

# Reset to default
/config reset <key>

# Show config file location
/config which

Configuration Levels

Global Config (~/.config/aikit/)

Applies to all projects. Contains:

  • Default agent selection
  • Quality gate configuration
  • Global skills and tools
  • Plugin settings
  • MCP server configuration

Location: ~/.config/aikit/aikit.json

Project Config (.aikit/)

Project-specific overrides. Contains:

  • Project-specific rules
  • Custom skills for this project
  • Project-specific commands
  • Project tools and plugins
  • Memory configuration

Location: .aikit/aikit.json

Arguments

ArgumentTypeRequiredDefaultDescription
getstringNo-Get configuration value
setstringNo-Set configuration value
resetstringNo-Reset key to default
whichflagNofalseShow config file locations
--globalflagNofalseUse global config
--projectflagNofalseUse project config

Configuration Keys

Default Agent

# Get default agent
/config get defaultAgent

# Set default agent
/config set defaultAgent @planner

Available values:

  • @planner - Strategic planning and coordination
  • @build - Primary execution agent
  • @rush - Fast execution with minimal planning
  • @review - Code review and quality assurance
  • @scout - External research agent
  • @explore - Fast codebase navigation
  • @vision - Visual analysis agent
  • @one-shot - End-to-end autonomous execution

Quality Gates

# Get quality gates
/config get qualityGates

# Add quality gate
/config set qualityGates.0.typecheck true

# Add custom gate
/config set qualityGates.custom.e2e "npm run e2e"

Standard gates:

  • typecheck - TypeScript compilation
  • test - All tests passing
  • lint - Code linting
  • build - Production build

MCP Server

# Get MCP server configuration
/config get mcpServer

# Configure MCP port
/config set mcpServer.port 8080

# Enable MCP server
/config set mcpServer.enabled true

Session Management

# Get session timeout
/config get session.timeout

# Set session timeout (in minutes)
/config set session.timeout 240

Memory Configuration

# Get memory settings
/config get memory

# Set memory retention (in days)
/config set memory.retention 30

Examples

View Configuration

# View all configuration
/config

# View specific section
/config agents
/config skills
/config qualityGates

Modify Configuration

# Set default agent to planner
/config set defaultAgent @planner

# Enable a quality gate
/config set qualityGates.1.e2e true

# Configure MCP server
/config set mcpServer.enabled true
/config set mcpServer.port 8080

Reset Configuration

# Reset default agent
/config reset defaultAgent

# Reset to defaults
/config reset --all

Configuration Files

Show Locations

# Show config file paths
/config which

Output:

Global Config: ~/.config/aikit/aikit.json
Project Config: .aikit/aikit.json
Global Skills: ~/.config/aikit/skills/
Project Skills: .aikit/skills/

View Config File

# View global config
cat ~/.config/aikit/aikit.json

# View project config
cat .aikit/aikit.json

Best Practices

Configuration Management

✅ DO:

  • Use project config for project-specific settings
  • Keep global config minimal and general
  • Document configuration changes
  • Use meaningful configuration keys
  • Test configuration after changes

❌ DON'T:

  • Commit configuration files with secrets
  • Override project config unnecessarily
  • Create overly complex configurations
  • Reset configuration without understanding impact
  • Ignore configuration validation errors

Default Agent Selection

Choose based on your workflow:

  • Planning-heavy tasks: @planner
  • Implementation tasks: @build
  • Quick fixes: @rush
  • Code review: @review
  • Research: @scout
  • Codebase exploration: @explore

Troubleshooting

Configuration Not Loading

# Check if config file exists
ls ~/.config/aikit/aikit.json

# Verify config file format
cat ~/.config/aikit/aikit.json

# Reset configuration if corrupted
/config reset --all

Invalid Configuration

# If configuration errors occur:
# Reset to defaults
/config reset --all

# Reinitialize
aikit init --global