Configuration

Complete configuration management reference for NikCLI

Overview

NikCLI provides comprehensive configuration management through multiple layers: global settings, project-specific configurations, session preferences, and runtime parameters. The configuration system supports environment variables, configuration files, command-line options, and interactive configuration wizards.

Multi-Layer Config

Global, project, session, and runtime configuration layers

Environment Integration

Seamless integration with environment variables and CI/CD

Security

Encrypted storage for sensitive configuration data

Validation

Configuration validation and error prevention

Configuration Commands

/config - Configuration Management

View Configuration

# Show all configuration
/config
/config --all --detailed

# Show specific sections
/config ai
/config security
/config agents

# Show configuration hierarchy
/config --hierarchy --sources

Set Configuration

# Set configuration values
/config set ai.default-model claude-3-sonnet
/config set security.approval-required true
/config set agents.max-concurrent 3

# Interactive configuration
/config setup --interactive
/config wizard --guided-setup

Configuration Files

# Export configuration
/config export --file nikcli.config.json
/config export --format yaml --pretty

# Import configuration
/config import --file config.json
/config import --merge --validate

AI Model Configuration

Model Selection

# Configure default AI model
/config set ai.default-model claude-3-sonnet
/config set ai.fallback-model gpt-4

# Model-specific settings
/config set ai.claude.temperature 0.3
/config set ai.gpt.max-tokens 4000

# Model availability configuration
/config set ai.providers "anthropic,openai"
/config set ai.model-rotation true

API Configuration

# Set API keys (encrypted storage)
/config set-key anthropic sk-ant-...
/config set-key openai sk-...

# API endpoint configuration
/config set api.anthropic.base-url https://api.anthropic.com
/config set api.timeout 30000
/config set api.retry-attempts 3

Security Configuration

Access Control

# Security mode configuration
/config set security.mode safe
/config set security.approval-required true
/config set security.command-restrictions strict

# File system permissions
/config set security.allowed-paths "src/,docs/,tests/"
/config set security.blocked-paths "node_modules/,.env"

Audit Configuration

# Audit logging
/config set audit.enabled true
/config set audit.level detailed
/config set audit.retention-days 90

# Compliance settings
/config set compliance.gdpr true
/config set compliance.data-retention 365d

Agent Configuration

Agent Behavior

# Default agent settings
/config set agents.default universal-agent
/config set agents.auto-select true
/config set agents.max-concurrent 3

# Agent-specific configuration
/config set agents.react-expert.temperature 0.2
/config set agents.backend-agent.context-size 8000

Performance Settings

# Performance optimization
/config set agents.performance.caching true
/config set agents.performance.parallel-execution true
/config set agents.performance.resource-limits enabled

Advanced Configuration

Environment-Specific Configuration

# Development environment
/config env development
/config set --env dev security.mode relaxed
/config set --env dev agents.debug true

# Production environment  
/config env production
/config set --env prod security.mode strict
/config set --env prod audit.level comprehensive

Project Configuration

# Project-specific settings
/config project-init
/config set --project tools.preferred typescript,react
/config set --project style.formatter prettier

Configuration Validation

# Validate configuration
/config validate
/config validate --strict --report-issues

# Check configuration compatibility
/config compatibility-check
/config --migration-required --suggestions

Next Steps

MCP Protocol

Learn about Model Context Protocol integration

Advanced Features

Explore advanced CLI capabilities

Token Management

Understand token optimization strategies

Caching

Learn about caching systems and optimization

Use /config wizard for first-time setup or when migrating between environments. The interactive wizard ensures all required settings are properly configured.