Configuration Reference

Complete reference for NexusCore configuration files, options, and precedence rules.

Config Files

NexusCore uses YAML configuration files at two levels:

Level	Path	Scope
User	~/.nexuscore/config.yaml	All projects on this machine
Project	.nexuscore/config.yaml	Current workspace only

Project-level settings override user-level settings. Both files use the same format.

Full Configuration Reference

See CLI Configuration for the complete config file format with all sections and options.

Quick Reference

# ~/.nexuscore/config.yaml

models:
  providers:
    - name: ollama
      endpoint: http://localhost:11434
      type: ollama
  default_model: llama3.1:8b
  routing:
    fast: llama3.1:8b
    code: codellama:13b
    reasoning: gpt-4o

agent:
  memory: true
  checkpoint_auto: true
  max_iterations: 50

tools:
  enabled: true
  allow_shell: true
  allow_web: true

sync:
  enabled: false
  auto_sync: true

Precedence

Configuration is resolved in this order (highest priority first):

1. Command-line flags — --model, --verbose, etc.
2. Environment variables — NEXUS_MODEL, NEXUS_VERBOSE, etc.
3. Project-level config — .nexuscore/config.yaml in the current workspace
4. User-level config — ~/.nexuscore/config.yaml
5. Built-in defaults

Related Pages

• Directory Structure — Full .nexuscore/ layout
• Environment Variables — All supported environment variables
• CLI Flags & Options — Command-line flags and their environment variable equivalents