Skip to content

Feature map

19 logical features.

FeatureDescriptionGuideDemo or checkSources
Agent runtime servicesProvides host-local task checkpoints with legacy metadata preservation, fast lifecycle hook startup, browser workspaces, local-agent launch, and managed Google MCP transport./agents/durable-work/df-task --helphome/dot_local/bin/executable_df-browser, home/dot_local/bin/executable_df-google-mcp, home/dot_local/bin/executable_df-task, home/dot_local/bin/executable_local-agent, home/dot_local/lib/dotfiles/df_task.py, install/google-mcp.py, install/local-agent.py
Codex agent stackInstalls complete native Codex runtimes with atomic activation and version-aware validation of the patched shell removed in 0.163.0, retires legacy npm launcher symlinks in managed roots including scratch-backed and PLAT layouts without deleting active package files, verifies PATH resolution, and raises Linux soft descriptor limits, resolves shell host policy without a Codex function, enables all managed Codex MCPs by default with explicit narrower profiles, and configures GPT-6.1 Sol defaults, GPT-6 Luna/GPT-6.1 Terra roles, host-local state, SSH OAuth callback ports, deterministic Linux OAuth storage, credential-file healthchecks, connection-time GitHub credentials, verified backups, and copy-only history migration. The shared skill registry includes standalone Ponytail change review without session hooks./agents/codex/bash install/codex.sh checkhome/.chezmoiignore, home/.chezmoitemplates/agents-common.md, home/.chezmoitemplates/resource-limits.sh, home/.chezmoitemplates/voice-common.md, home/dot_agents/symlink_skills, home/dot_codex/AGENTS.md.tmpl, home/dot_codex/agents/coder.toml, home/dot_codex/agents/explorer.toml, home/dot_codex/agents/extractor.toml, home/dot_codex/agents/patcher.toml, home/dot_codex/agents/researcher.toml, home/dot_codex/agents/reviewer.toml, home/dot_codex/agents/verifier.toml, home/dot_codex/context.config.toml, home/dot_codex/create_private_config.toml, home/dot_codex/deep.config.toml, home/dot_codex/executable_rtk-rewrite.sh, home/dot_codex/fast.config.toml, home/dot_codex/hooks.json, home/dot_codex/review.config.toml, home/dot_codex/rules/dotfiles.rules, home/dot_codex/themes/minty-terminal.tmTheme, home/dot_codex/themes/neon-noir.tmTheme, home/dot_codex/themes/sunburst-candy.tmTheme, home/dot_local/bin/executable_df-agent-doctor, home/dot_local/bin/executable_df-chezmoi-guard, home/dot_local/bin/executable_plugin-eval, home/run_onchange_agent-tools.sh.tmpl, home/run_onchange_before_skill-ownership.sh.tmpl, home/run_onchange_codex.sh.tmpl, home/run_onchange_skills.sh.tmpl, install/agent-tools.sh, install/codex-config.py, install/codex-runtime.sh, install/codex-history.py, install/codex-backup.py, install/codex.sh, install/skills-sync.sh, packages/agent-skills.lock.json, packages/agent-skills.txt, packages/codex-agent-tools.json, packages/codex-plugins.txt, packages/mcp-servers.txt
AuthenticationSets up managed service credentials, separate Google consent paths, private-overlay SSH policies, and host-specific Codex MCP OAuth callback ports for browser sign-in through SSH./setup/auth/sed -n '1,120p' install/auth.shhome/.chezmoitemplates/opencode-credentials.sh, home/dot_ssh/config.tmpl, install/auth.sh
Bootstrap orchestrationCoordinates install, update, and upgrade with runtime host presets, local overrides, platform-aware paths, maintained sudo authentication, and completion only after required runtime and version checks; informational notices remain separate from installation degradations./setup/bootstrap/sed -n '93,106p' bootstrap.shbootstrap.sh, home/.chezmoi.toml.tmpl, home/.chezmoidata.toml, home/.chezmoiremove, home/.chezmoitemplates/plat-detect.sh, install/_lib.sh, install/_runtime-paths.sh, install/_host-config.sh, install/host.sh, install/agent-runtime.sh, install/dirs.sh, install/plat/plat_Darwin_arm64/.plat_check.sh, install/plat/plat_Darwin_arm64/.plat_env.sh, install/plat/plat_Darwin_x86-64/.plat_check.sh, install/plat/plat_Darwin_x86-64/.plat_env.sh, install/plat/plat_Linux_aarch64/.plat_check.sh, install/plat/plat_Linux_aarch64/.plat_env.sh, install/plat/plat_Linux_x86-64-v2/.plat_check.sh, install/plat/plat_Linux_x86-64-v2/.plat_env.sh, install/plat/plat_Linux_x86-64-v3/.plat_check.sh, install/plat/plat_Linux_x86-64-v3/.plat_env.sh, install/plat/plat_Linux_x86-64-v4/.plat_check.sh, install/plat/plat_Linux_x86-64-v4/.plat_env.sh, install/verify-tools.sh
Claude CodeConfigures Claude instructions, plugins, scoped hooks, and transcript status reporting, with Opus 5.5 at xhigh effort for new sessions. Stops before plugin changes when the marketplace inventory cannot load, preserving authentication and managed-policy diagnostics./agents/claude/claude plugin list --jsonhome/.chezmoitemplates/claude-defaults.sh, home/dot_claude/CLAUDE.md.tmpl, home/dot_claude/RTK.md, home/dot_claude/agents/researcher.md, home/dot_claude/agents/reviewer.md, home/dot_claude/executable_chezmoi-guard.sh, home/dot_claude/executable_gcloud-mcp-headers.sh, home/dot_claude/executable_gh-mcp-headers.sh, home/dot_claude/executable_hook-scope.sh, home/dot_claude/executable_rtk-rewrite.sh, home/dot_claude/executable_statusline.sh, home/dot_claude/output-styles/cade.md.tmpl, home/dot_claude/settings.json, home/dot_claude/statusline_stats.py, home/run_onchange_claude.sh.tmpl, install/claude-hook-scope.py, install/claude.sh, packages/claude-plugins.txt
Core toolchainsInstalls shell, language, compiler, documentation, and workflow-validation tools, streams Homebrew Bundle build output, prefers configured host-local state for uv cache locks while preserving overrides, generates both supported Linux UTF-8 locales, updates TinyTeX’s manager before package operations, selects Homebrew OpenSSL 3 for locked Cargo source builds while preserving explicit OpenSSL paths, checks Linux checksum execution before downstream installers, and maintains a 250 GiB sccache policy, native build launchers, Python bytecode caching, and Gradle task caching./setup/packages/bash install/verify-path.sh --helphome/dot_bash_profile.tmpl, home/dot_zprofile.tmpl, home/.chezmoitemplates/compiler-cache.sh, home/dot_config/sccache/config.tmpl, home/Library/Application Support/Mozilla.sccache/symlink_config, home/dot_gradle/gradle.properties, home/run_onchange_brew.sh.tmpl, home/run_onchange_cargo.sh.tmpl, home/run_onchange_go.sh.tmpl, home/run_onchange_python.sh.tmpl, install/brew-shell.sh, install/cmake.sh, install/cmake/toolchains/_cache.cmake, install/cmake/toolchains/gcc-13.cmake, install/cmake/toolchains/gcc-15.cmake, install/cmake/toolchains/llvm-21.cmake, install/cmake/toolchains/llvm-22.cmake, install/go.sh, install/homebrew.sh, install/julia.sh, install/latex.sh, install/lean.sh, install/linux-packages.sh, install/lldb.sh, install/node.sh, install/python.sh, install/quarto.sh, install/rust.sh, install/verify-path.sh, install/zsh.sh, packages/Brewfile, packages/cargo.txt, packages/go.txt, packages/npm-allow-scripts.txt, packages/npm.txt, packages/pip-full.txt, packages/pip.txt, packages/python.txt
Creative automationInstalls the opt-in Blender MCP bridge for project-scoped scene work./usage/gamedev/sed -n '1,100p' install/blender-mcp.shinstall/blender-mcp.sh
Cursor IDE and cloud agentsConfigures Cursor instructions, Composer 2.5 subagents, shared-skill migration, MCP, CLI merge, and the self-hosted computer-use worker./agents/cursor/bash install/cursor.sh checkhome/.chezmoitemplates/cursor-agents.md, home/Library/LaunchAgents/dev.cade.cursor-worker.plist.tmpl, home/dot_config/cursor/keybindings.json, home/dot_config/cursor/settings.json, home/dot_cursor/AGENTS.md.tmpl, home/dot_cursor/agents/debugger.md, home/dot_cursor/agents/researcher.md, home/dot_cursor/agents/reviewer.md, home/dot_cursor/agents/verifier.md, home/dot_cursor/create_cli-config.json, home/dot_cursor/hooks.json, home/dot_cursor/hooks/executable_rtk-rewrite.sh, home/dot_cursor/hooks/executable_sync-dotfiles-cursor.sh.tmpl, home/dot_cursor/hooks/sync_dotfiles_cursor.py, home/dot_cursor/rules/personal.mdc.tmpl, home/dot_cursor/symlink_skills, home/dot_local/bin/executable_df-cursor-worker, home/run_onchange_cursor.sh.tmpl, install/cursor.sh, packages/cursor-extensions.txt
Desktop and editorsInstalls and configures desktop coding tools, macOS settings, service integrations, and GPT-6.1 Sol for iTerm’s OpenAI Responses API helper./usage/ai-workbench/sed -n '1,80p' install/macos-settings.shhome/dot_aerospace.toml, home/dot_config/vscode/settings.json, home/dot_iterm2/com.googlecode.iterm2.plist, home/dot_local/bin/executable_macprof, home/run_onchange_macos-quick-actions.sh.tmpl, home/run_onchange_vscode.sh.tmpl, install/claude-desktop.sh, install/codex-desktop.sh, install/linearmouse.sh, install/macos-quick-actions.sh, install/macos-services.sh, install/macos-settings.sh, install/vscode.sh, packages/vscode-extensions.txt
Gemini and Google APIsInstalls Gemini and Workspace CLIs, separates Gemini, Cloud, and selected Workspace consent paths, exposes a complete Workspace MCP tool tier and shared authoring workflow, and provides a locked Developer API and Live audio probe./usage/google-ai/df-gemini --check-runtimeinstall/gemini-api.py, install/gemini-api.py.lock, home/dot_local/bin/executable_df-gemini
Google WorkspaceConfigures a pinned, complete-tier Workspace MCP with separate Desktop OAuth consent and a shared native Docs, Sheets, and Slides authoring workflow./usage/google-workspace/bash install/auth.sh helphome/dot_local/bin/executable_df-workspace-mcp, home/dot_claude/skills/google-workspace-flow/SKILL.md
Homebrew compatibility patchesApplies reviewed package-manager compatibility patches during bootstrap, including an explicit OpenSSL dependency for source-built Coreutils checksum tools and systemd/Mesa wheel patches that follow formula-owned Python and resource versions while preserving resource exclusions and bindgen settings. Formula patch scripts retain macOS system Bash 3.2 compatibility with explicit syntax and fixture coverage./usage/troubleshooting/sed -n '1,80p' install/patch-homebrew-python.shinstall/patch-homebrew-apache-serf.sh, install/patch-homebrew-cc65.sh, install/patch-homebrew-coreutils.sh, install/patch-homebrew-fastfetch.sh, install/patch-homebrew-fish.sh, install/patch-homebrew-gecode.sh, install/patch-homebrew-m4.sh, install/patch-homebrew-mesa.sh, install/patch-homebrew-ncurses.sh, install/patch-homebrew-netpbm.sh, install/patch-homebrew-openssh.sh, install/patch-homebrew-optflags.sh, install/patch-homebrew-pkgconf.sh, install/patch-homebrew-python.sh, install/patch-homebrew-rpm.sh, install/patch-homebrew-ruby.sh, install/patch-homebrew-stdenv.sh, install/patch-homebrew-superenv.sh, install/patch-homebrew-systemd.sh
Knowledge and memoryConfigures qmd knowledge retrieval and the manual cass session archive workflow./workflows/knowledge-and-memory/qmd statushome/Library/LaunchAgents/dev.cade.qmd.plist.tmpl, home/dot_config/qmd/index.yml.tmpl, home/run_onchange_memory.sh.tmpl, install/memory.sh
Local AI toolingManages local-model setup and its host-side runtime checks./usage/local-llm/sed -n '1,120p' install/local-llm.shhome/Library/LaunchAgents/dev.cade.mlxserve.plist.tmpl, home/run_onchange_local-llm.sh.tmpl, install/local-llm.sh, packages/mlx-models.txt
Mathematics automationExposes an installed Wolfram Engine through a local MCP wrapper./usage/math/sed -n '1,80p' home/dot_local/bin/executable_wolfram-mcphome/.chezmoitemplates/math-common.md, home/dot_local/bin/executable_wolfram-mcp
OpenCode and PiConfigures local MLX defaults on macOS, Haiku 5.5 cloud defaults on Linux, Fable 5.1 planning and Sonnet 5.5 review in OpenCode, MCP-scoped agents, and thin local extensions./agents/opencode-and-pi/bash install/opencode.sh checkhome/dot_config/opencode/AGENTS.md.tmpl, home/dot_config/opencode/create_private_opencode.json.tmpl, home/dot_config/opencode/plugin/chezmoi-guard.ts, home/dot_config/opencode/plugin/git-context.ts, home/dot_config/opencode/plugin/rtk.ts, home/dot_config/opencode/themes/dotfiles.json, home/dot_config/opencode/tui.json, home/dot_pi/agent/AGENTS.md.tmpl, home/dot_pi/agent/extensions/chezmoi-guard.ts, home/dot_pi/agent/extensions/rtk.ts, home/dot_pi/agent/models.json.tmpl, home/dot_pi/agent/settings.json.tmpl, home/dot_pi/agent/themes/dotfiles.json, home/run_onchange_opencode.sh.tmpl, install/opencode.sh
Publication validationValidates each outgoing commit in an independent checkout, isolates test runtime roots, and permits Docker to read snapshots on NFS without granting other users write access./usage/validation/./tests/ci.sh full.githooks/pre-push, tests/pre-push.sh, tests/install-hooks.sh, tests/ci.sh
Shell and terminal runtimeApplies Bash, Zsh, and Fish startup, terminal, editor, Git, and command-line preferences./workflows/shell-editor-terminal/sed -n '1,160p' home/dot_zshrc.tmplhome/.chezmoitemplates/locale-env.sh, home/.chezmoitemplates/nvm-default.sh, home/dot_bashrc.tmpl, home/dot_config/ghostty/config, home/dot_config/git/ignore, home/dot_config/nvim/init.lua, home/dot_config/ripgrep/ripgreprc, home/dot_gitconfig.tmpl, home/dot_inputrc, home/dot_profile.tmpl, home/dot_pythonrc, home/dot_tmux.conf, home/dot_zshrc.tmpl, home/dot_config/fish/conf.d/00-dotfiles-env.fish, home/dot_config/fish/conf.d/dotfiles-env-bridge.bash.tmpl, home/dot_config/fish/conf.d/uv.env.fish
Workspace maintenanceMaintains chezmoi, scratch layout, Git workflows, platform cleanup, and version audits, with a minimum Quarto baseline for the unpinned macOS cask and an exact selected Linux archive pin./setup/chezmoi/git wt helphome/dot_local/bin/executable_git-wt, home/run_onchange_git-tools.sh.tmpl, install/audit-versions.sh, install/chezmoi.sh, install/git-tools.sh, install/plat-decommission.sh, install/scratch.sh