Profile Management

/profile list

# Shows all available profiles with details:
# - Profile name and description
# - Provider type (openai, anthropic, azure_openai, gemini, custom)
# - Model identifier
# - Temperature and max_tokens settings
# - Active profile indicator (*)

/profile set claude

# Activates the 'claude' profile
# Changes persist across sessions (saved to config)

/profile create

# Interactive wizard prompts:
# 1. Profile name (alphanumeric, hyphens, underscores)
# 2. Provider type (auto/openai/anthropic/azure_openai/gemini/openrouter/custom)
# 3. API key (masked: sk-...xyz)
# 4. Model (e.g., gpt-4, claude-sonnet-4)
# 5. Temperature (0.0-2.0, default: 0.7)
# 6. Max tokens (default: 4096)
# 7. Base URL (for custom providers, optional)
# 8. Organization ID (OpenAI only, optional)
# 9. Advanced settings prompt (y/n)
#    - Description
#    - Timeout (milliseconds, 0 = no timeout)
#    - Tool calling support (y/n)
#    - Streaming enabled (y/n)

# Profile validation and auto-detection:
# - Provider auto-detected from API key format
# - Profile name uniqueness check
# - Configuration validation before saving

# Override model for 'claude' profile
export KOLLABOR_CLAUDE_MODEL="claude-opus-4"

# Override API key for 'openai' profile
export KOLLABOR_OPENAI_API_KEY="sk-..."

# Override temperature for custom profile
export KOLLABOR_MY_PROFILE_TEMPERATURE="0.9"

# Override base URL for local profile
export KOLLABOR_LOCAL_BASE_URL="http://localhost:11434/v1"

# Override max tokens
export KOLLABOR_FAST_MAX_TOKENS="2048"

# Override timeout (milliseconds, 0 = no timeout)
export KOLLABOR_CLAUDE_TIMEOUT="120000"

# Override streaming (true/false)
export KOLLABOR_OPENAI_STREAMING="false"

# Override tool support (true/false)
export KOLLABOR_CUSTOM_SUPPORTS_TOOLS="true"

# Special characters in profile names become underscores
# "my-local-llm" → KOLLABOR_MY_LOCAL_LLM_MODEL
# "fast.api" → KOLLABOR_FAST_API_API_KEY

# Define profile via environment (MODEL is required)
export KOLLABOR_PRODUCTION_MODEL="gpt-4-turbo"
export KOLLABOR_PRODUCTION_API_KEY="sk-..."
export KOLLABOR_PRODUCTION_PROVIDER="openai"
export KOLLABOR_PRODUCTION_TEMPERATURE="0.5"

# Activate profile (auto-created if not in config)
/profile set production

# Profile is created in memory for the session
# Not saved to config.json unless explicitly created via wizard

{
  "id": "main",
  "name": "Main Model",
  "description": "Production LLM for general use",
  "enabled": true,
  "provider": "openai-compatible",
  "apiUrl": "http://localhost:1234/v1/chat/completions",
  "apiKey": "not-needed",
  "model": "ibm/granite-4-h-tiny",
  "temperature": 0.7,
  "maxTokens": 4096,
  "customHeaders": {
    "X-Custom-Header": "value"
  },
  "streaming": {
    "streamTimeout": 90000,
    "retryAttempts": 3,
    "retryDelay": 1000
  }
}

{
  "id": "code-helper",
  "name": "Code Helper",
  "icon": "code",
  "systemPrompt": "You are an expert programming assistant...",
  "llmProfileId": "main",
  "enableToolCalling": true,
  "toolConfirmation": "auto",
  "maxToolIterations": 10,
  "builtin": false
}

# Global profiles (user-wide)
~/.kollabor-cli/config.json
  └── core.llm.profiles
      ├── profile_name
      │   ├── provider
      │   ├── model
      │   ├── temperature
      │   ├── max_tokens
      │   ├── api_key
      │   ├── base_url
      │   └── ...
      └── active_profile

# Profiles are user-level settings
# Available across all projects
# Persisted in JSON format

# App configuration
~/.kollabor/config.json
  └── llmSettings
      ├── apiProfiles (LLM API profiles)
      ├── activeApiProfiles (feature assignments)
      ├── chatProfiles (chat personalities)
      ├── transcriptionProfiles
      └── notesProfiles

# Profile objects stored as { id: profile }
# Composables inject 'id' field when iterating
# Backend uses settings module for defaults