contextune:config

Contextune Configuration Management

Manage the unified .contextune-config.yaml configuration file for both Contextune and HtmlGraph.

Commands

Initialize Configuration

Create a new default configuration file:

uv run python -c "
from lib.contextune_integration.config_loader import ConfigLoader
from pathlib import Path

loader = ConfigLoader()
config = loader.create_default()

print(f'✅ Created config: {loader.config_path}')
print(f'   Edit the file to customize settings')
"

Creates ~/.contextune-config.yaml with default values.

Show Current Configuration

Display the current configuration:

uv run python -c "
from lib.contextune_integration.config_loader import get_config
import yaml

config = get_config()
data = config.model_dump(mode='json')

print('Current Configuration:')
print('=' * 50)
print(yaml.dump(data, default_flow_style=False, sort_keys=False))
print('=' * 50)
print(f'Config file: {config.get_default_path()}')
"

Validate Configuration

Check if your configuration file is valid:

uv run python -c "
from lib.contextune_integration.config_loader import ConfigLoader

loader = ConfigLoader()
is_valid, errors = loader.validate()

if is_valid:
    print('✅ Configuration is valid')
else:
    print('❌ Configuration has errors:')
    for error in errors:
        print(f'   - {error}')
"

Reload Configuration

Reload configuration from disk (useful after manual edits):

uv run python -c "
from lib.contextune_integration.config_loader import reload_config

config = reload_config()
print('✅ Configuration reloaded')
print(f'   Integration enabled: {config.integration.enabled}')
print(f'   Auto-create tracks: {config.htmlgraph.tracking.auto_create_tracks}')
"

Configuration Structure

Contextune Section

contextune:
  intent_detection:
    keyword_threshold: 1.0        # Exact match for keywords
    model2vec_threshold: 0.85     # Model2Vec similarity
    semantic_threshold: 0.7       # Semantic Router confidence
    enable_haiku_analysis: true   # Enable Haiku interactive analysis

  parallel_execution:
    max_agents: 5                 # Maximum parallel agents
    default_model: haiku          # Default model (haiku|sonnet|opus)
    timeout_minutes: 30           # Execution timeout

  data_dir: ~/.claude/plugins/contextune/data  # Contextune data directory