Configuration

SWUST Code uses JSON/JSONC config files for models, permissions, providers, MCP, agents, plugins, and TUI behavior.

Config Locations

Scope	Paths
Global	~/.config/swust-code/config.json, swust-code.json, swust-code.jsonc
Project	swust-code.json, swust-code.jsonc discovered upward from the current directory
Project directory	.swust-code/swust-code.json, .swust-code/swust-code.jsonc
TUI	tui.json, tui.jsonc in global or project .swust-code directories

Project config overrides global config, and the closest project config wins. Use SWUST_CODE_CONFIG for one explicit file or SWUST_CODE_CONFIG_DIR for an additional config directory.

Basic Config

{
  "$schema": "https://opencode.ai/config.json",
  "model": "anthropic/claude-sonnet-4-6",
  "permission": {
    "bash": "ask",
    "edit": "allow",
    "read": "allow"
  }
}

Skill Sources

{
  "skills": {
    "paths": [".swust-code/skills"],
    "urls": ["https://example.com/.well-known/skills/"]
  }
}

The CLI/TUI path currently reads this v1 object shape. The core v2 layer adapts these entries into local directory or remote URL sources internally.

Environment Variables

Variable	Description
SWUST_CODE_CONFIG	Use one explicit config file
SWUST_CODE_CONFIG_DIR	Custom config directory
SWUST_CODE_CONFIG_CONTENT	Inject config content from an environment variable
SWUST_CODE_DISABLE_PROJECT_CONFIG	Disable project config discovery
SWUST_CODE_DB	Custom database path
SWUST_CODE_PURE	Disable external plugins
SWUST_CODE_DISABLE_MODELS_FETCH	Disable model catalog refresh
SWUST_CODE_SERVER_PASSWORD	Password for serve and web
SWUST_CODE_SERVER_USERNAME	Username for serve and web
SWUST_CODE_MEMORY_RECONCILE_ON_SEARCH	Auto-sync memory before search (default: true)