Dotfiles

Managed with yadm. Clone on a new machine:

yadm clone <repo-url>
yadm bootstrap

---

Tools

Terminal

cmux

Native macOS terminal built on libghostty. Vertical tabs, notification rings for agents, split panes, and a socket API for automation.

# Download DMG
open https://github.com/manaflow-ai/cmux/releases/latest/download/cmux-macos.dmg

Config: ~/.config/ghostty/config (cmux reads Ghostty keybindings)

Ghostty

GPU-accelerated terminal emulator. cmux uses libghostty under the hood, but standalone Ghostty is also installed.

brew install --cask ghostty

Config: ~/.config/ghostty/config

---

Shell

Fish

Primary shell. Plugins managed via Fisher.

Tracked by yadm: config.fish, fish_plugins, and custom wt*/__wt_* functions (worktrunk helpers). Plugin-managed files (tide, fisher, autopair, puffer, sponge, vesper-theme) are not tracked — they're restored by Fisher.

brew install fish

# Set as default shell
echo /opt/homebrew/bin/fish | sudo tee -a /etc/shells
chsh -s /opt/homebrew/bin/fish

# Install Fisher
curl -sL https://raw.githubusercontent.com/jorgebucaran/fisher/main/functions/fisher.fish | source
fisher install jorgebucaran/fisher

# Restore all plugins from fish_plugins (tide, autopair, puffer, sponge, vesper-theme)
fisher update

# Configure tide prompt
tide configure

Config: ~/.config/fish/config.fish Plugins (from fish_plugins): tide, autopair, puffer, sponge, vesper-theme

---

Claude Code Plugins

RTK (Rust Token Killer)

CLI proxy that reduces LLM token consumption by 60-90% on common dev commands. Hooks into Claude Code transparently.

brew install rtk
rtk init -g          # Install hook + RTK.md
# Verify
rtk --version
rtk gain             # Show token savings

Config: ~/.claude/RTK.md (auto-installed by rtk init -g)

context-mode

MCP plugin that virtualizes Claude Code's context window. Routes large outputs through a sandboxed FTS5 knowledge base so raw tool output never floods the conversation.

# Inside Claude Code:
/plugin marketplace add mksglu/context-mode
/plugin install context-mode@context-mode

# Verify
/context-mode:ctx-doctor

Slash commands: /context-mode:ctx-stats, /context-mode:ctx-doctor, /context-mode:ctx-upgrade

claude-hud

Status line plugin showing context usage, active tools, running agents, and task progress.

# Inside Claude Code:
/plugin marketplace add jarrodwatts/claude-hud
/plugin install claude-hud
/claude-hud:setup
# Restart Claude Code

fff (Fast File Finder)

Frecency-ranked file search MCP server. Also a Neovim plugin. Boosts git-dirty files and recently/frequently accessed files.

curl -L https://dmtrkovalenko.dev/install-fff-mcp.sh | bash

Add to CLAUDE.md:

For any file search or grep in the current git indexed directory use fff tools

Plannotator

Plan and code review UI for AI coding agents. Annotate agent plans before they execute, review diffs before committing.

curl -fsSL https://plannotator.ai/install.sh | bash

Slash commands: /plannotator-review, /plannotator-annotate, /plannotator:plannotator-last

Impeccable

Design fluency skills for AI harnesses. Enhanced frontend-design skill + 20 design commands (/polish, /audit, /typeset, /overdrive, etc.).

npx skills add pbakaus/impeccable

# Or inside Claude Code:
/plugin marketplace add pbakaus/impeccable

# One-time project setup:
/teach-impeccable

Update: npx skills update

---

OpenClaw

Personal AI assistant gateway. Runs locally, connects to any model provider.

Config contains auth tokens — NOT tracked by yadm. Set up manually on each machine.

# Install
openclaw onboard --install-daemon

# Start the gateway
openclaw gateway --port 18789 --verbose

# Verify
openclaw doctor

Config: ~/.openclaw/openclaw.json (model + auth — do NOT commit)

{
  "agent": {
    "model": "anthropic/claude-opus-4-6"
  }
}

Docs: Getting started | Configuration | Models + auth

OpenClaw Skills

Custom skills live at ~/.agents/skills/. Install third-party skills with npx skills add <repo>. The tracked skills below are project-specific and managed by yadm.

Skill	Description
dalp-dev	DALP project development conventions
dev-status	Development status reporting

---

Editor

Neovim

AstroNvim-based config with fff.nvim integration.

brew install neovim

Config: ~/.config/nvim/

Zed

Secondary editor.

Config: ~/.config/zed/settings.json, ~/.config/zed/prompts/, ~/.config/zed/themes/

---

Other Tools

Tool	Config
lazygit	~/.config/lazygit/config.yml
btop	~/.config/btop/btop.conf
Karabiner-Elements	~/.config/karabiner/karabiner.json
bat	~/.config/bat/

---

Package Management

All Homebrew formulae and casks tracked in ~/.Brewfile:

# Restore on new machine
brew bundle --global

# Update after installing/removing packages
brew bundle dump --global --force