Configuration

No cloud account, no config server — everything DevCompass tracks stays on disk, either globally or inside your project.

On this page

File Locations
Config Files
config Command

File Locations

Everything lives locally.

Global — ~/.devcompass/

~/.devcompass/history.dbSnapshot database

~/.devcompass/cve.dbCVE cache

~/.devcompass/ai.dbAI conversation history

~/.devcompass/config.dbConfiguration

~/.devcompass/llm.dbLLM provider settings

Per-project

<project>/.devcompass-backups/Backup files (created before every fix)

<project>/.devcompass-cache.jsonAnalysis cache

<project>/devcompass.config.jsonOptional project-level configuration

Configuration Files

Dynamic tracking & fix-classification data.

data/tracked-repos.jsonGitHub repositories to monitor

data/popular-packages.jsonCommon package patterns

data/quality-alternatives.jsonDeprecated package replacements

data/gpl-alternatives.jsonGPL license alternatives

data/batch-categories.jsonFix categorization rules

data/priorities.jsonPriority classification

The config Command

Manage settings from the CLI.

# Set GitHub token (avoid rate limits)
$ devcompass config --github-token YOUR_TOKEN
 
# Show current configuration
$ devcompass config --show
 
# Remove GitHub token
$ devcompass config --remove-github-token