Configuration

Hyprlayer stores its configuration in a JSON file.

Location

Platform	Path
Linux	~/.config/hyprlayer/config.json
macOS	~/Library/Application Support/hyprlayer/config.json
Windows	%APPDATA%\hyprlayer\config.json

Override with --config-file <PATH> on any command.

View Configuration

hyprlayer thoughts config

hyprlayer thoughts config --json

hyprlayer thoughts config --edit

Schema

{
  "thoughts": {
    "thoughtsRepo": "~/thoughts",
    "reposDir": "repos",
    "globalDir": "global",
    "user": "alice",
    "agentTool": "claude",
    "opencodeProvider": "github-copilot",
    "opencodeSonnetModel": "github-copilot/claude-sonnet-4.5",
    "opencodeOpusModel": "github-copilot/claude-opus-4.5",
    "repoMappings": {
      "/home/alice/Projects/my-project": "my-project",
      "/home/alice/Projects/work-app": {
        "repo": "work-app",
        "profile": "work"
      }
    },
    "profiles": {
      "work": {
        "thoughtsRepo": "~/work-thoughts",
        "reposDir": "repos",
        "globalDir": "global"
      }
    },
    "lastVersionCheck": 1709913600,
    "disableUpdateCheck": false
  }
}

Fields

Core Settings

Field	Type	Description
thoughtsRepo	string	Path to the thoughts repository
reposDir	string	Subdirectory name for project-specific thoughts
globalDir	string	Subdirectory name for cross-project thoughts
user	string	Your username (cannot be “global”)

AI Settings

Field	Type	Description
agentTool	string	AI tool: "claude", "copilot", or "opencode"
opencodeProvider	string	OpenCode provider: "github-copilot", "anthropic", or "abacus"
opencodeSonnetModel	string	Sonnet model ID for OpenCode
opencodeOpusModel	string	Opus model ID for OpenCode

Repository Mappings

Field	Type	Description
repoMappings	object	Maps local repo paths to thoughts directory names

Each mapping can be a simple string (directory name) or an object with repo and optional profile fields.

Profiles

Field	Type	Description
profiles	object	Named profiles with their own thoughtsRepo, reposDir, and globalDir

Update Settings

Field	Type	Description
lastVersionCheck	number	Unix timestamp of last update check
disableUpdateCheck	boolean	Set to true to disable automatic update checks