The global mise configuration (mise/.config/mise/config.toml) pins the shared developer toolchain, including the Skills CLI used by dot skill-updates and memex for browsing and searching local coding-agent history. The matching Herdr plugin provides session palettes, browsing, resume, indexing, and web UI actions. Node.js and Bun versions are also declared in the repository root mise.toml for dot and docs tasks.
Python 3.14 and uv are installed through mise for Python package and virtual-environment management. Use uv directly for project work; topgrade leaves mise pins unchanged unless you run mise install or dot update.
The stowed mise wrapper keeps the global config under dotfiles control. Commands such as Omarchy’s mise use -g <tool> are redirected to ~/.local/state/mise/omarchy-config.toml, while reads, installs, upgrades, and project-local writes continue normally. To intentionally change the stowed global config, opt in explicitly:
Terminal window
mise--write-global-configuse-g--pinnode@26
The configuration also provides the Android SDK command-line tools and sets the SDK environment for Gradle and sdkmanager. Individual Android repositories still declare their required platform and build-tools versions; install those SDK packages with sdkmanager when a checkout requires them.
Private git repo config for git-diff, git-log, git-workflows, git-notifications --bar-json, update, and doctor (default $DOTFILES_PRIVATE_DIR/dot-git.yml).
DOT_GITHUB_RETRIES
Extra gh retry attempts after the first try (default 2).
DOT_GITHUB_RATE_LIMIT_TTL_SECONDS
Seconds to cache gh api rate_limit results (default 60).
DOT_GITHUB_RATE_LIMIT_MIN_REMAINING
Minimum REST quota remaining before gh calls wait (default 0).
DOT_GITHUB_RATE_LIMIT_MAX_WAIT_SECONDS
Upper bound on rate-limit backoff waits (default 60).
DOT_FETCH_TTL_SECONDS
Seconds to reuse the last upstream fetch (default 300).
DOT_GH_EXTENSIONS_FILE
Public gh extension list installed by dot init (default $DOTFILES_PUBLIC_DIR/.dot-gh-extensions).
DOT_GH_MCP_BEARER
Bearer token for the read-only GitHub MCP server. The shell wrappers and opencode-server set it only for agent harness processes; it is not exported globally.
dot agents-sync mirrors ~/.config/opencode/AGENTS.md to agent harness instruction files. It runs automatically at the end of full dot update and dot init; phase-scoped updates skip it. There is no environment toggle to disable it.
Each target receives a transformed copy with harness-appropriate formatting where needed. All targets include a dot agents-sync HTML comment with source path and timestamp. OpenCode remains the single source of truth; other agent harnesses get plain file copies, not symlinks.
Variable
Description
DOT_AGENTS_SYNC_SOURCE
AGENTS file to mirror (default ~/.config/opencode/AGENTS.md).
DOT_AGENTS_SYNC_RULE_FILE
Override path for a primary agents-sync target (default ~/.cursor/rules/global-agents.mdc).
Disable automatic live dot usage recording when set to 1; explicit backfill still writes.
DOT_CONTEXT_CAPTURE
Capture assembled OpenCode starter context when set to 1.
DOT_CONTEXT_CAPTURE_DIR
Parent for private context-baseline-* capture directories (default /tmp/opencode).
NO_COLOR
Disable ANSI colour in TTY-aware output such as context git (any non-empty value).
Context capture writes numbered system-prompt segments, system-index.json, per-tool schemas, and tools.jsonl into a unique private child directory. It measures assembled context without changing prompts or tool definitions.
