The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Dotfiles with Claude Code workflow files
This repo packages a personal macOS dotfiles setup plus Claude Code workflow files, local plugins, and skills. The dotbot install uses `install.conf.yaml`, while the `Makefile` handles setup tasks like Homebrew, VS Code extensions, Karabiner compilation, and macOS defaults.
Builders who want their Claude Code setup, shell, and terminal behavior kept in one dotfiles repo.
You can install a full local setup for shell, terminal, keybindings, and Claude Code workflows from one repo.
What it does
Claude Code workflow files
`CLAUDE.md`, `claude/commands`, and `claude/skills` define task, plan, and review workflows for Claude Code.
Local Claude plugins
`claude/local-plugins/` includes auto-approve, git guardrails, sounds, and tmux agent status hooks for agent runs.
Statusline tooling
`claude/statusline-command.sh` and related scripts render directory, git, PR, model, and context information.
Shell and alias setup
`zsh/`, `aliases/`, `functions/`, and `path/` hold shell config, command shortcuts, and helper functions.
Mac keybinding setup
`karabiner/karabiner.ts` defines global key remaps, a Hyper key, and app focus shortcuts.
Dotbot installation
`install.conf.yaml` and the root install flow wire the repo into the target machine through Dotbot.
How to get it
- 1Run
git clone git@github.com:denolfe/dotfiles.git .dotfiles --recursive cd .dotfiles make install
README
denolfe's dotfiles
Personal dotfiles configuration

| Component | Tool | Config |
|---|---|---|
| Installation | Dotbot | install.conf.yaml |
| Terminal | Ghostty | config |
| Prompt | Powerlevel10k | customizations, config |
| .zshrc | oh-my-zsh | .zshrc |
| Global Key Rebinds, Hyper Key, App Focus | Karabiner | karabiner.ts |
| Claude AI Agent | Claude Code | claude/ |
| Pi AI Agent | Pi | pi/ |
Makefile
- Install with dotbot
- Homebrew save/restore
- VS Code extension save/restore
- Karabiner config compilation
- Install MacOS defaults
Claude Code
CLAUDE.md
- Critical partner mindset - Question assumptions, prioritize truth over agreement, be extremely concise
- Superpowers plan workflow - Plans in
~/.claude/plans/{timestamp}-{issue-number}-{task-name}/(1-TASK.md,2-DESIGN.md,3-PLAN.md) - TypeScript patterns - Single object params, types over interfaces, functions over classes, pure functions
- Bash permission matching - Never use
git -C, alwayscd /path && git <cmd>
Statusline
- Directory, git branch, PR#, staged/modified/untracked counts, model name, context % gradient bar
Slash Commands
| Command | Description |
|---|---|
/task | Create task folder with 1-TASK.md, option to brainstorm 2-DESIGN.md |
/implement-plan | Execute PLAN.md with subagent-driven dev and code review between tasks |
/pr create | Create PR from template, architecture-focused with mermaid diagrams |
/pr update | Update existing PR body to reflect current commits |
Plugins
External (via set-defaults.sh):
- superpowers - Skills for brainstorming, TDD, debugging, code review workflows
- payload - Payload CMS development helpers
- typescript-lsp - TypeScript language server integration
| Plugin | Purpose |
|---|---|
| auto-approve | Auto-approves compound bash commands when each part is allowed |
| git-guardrails | Blocks git add -A/., prompts for --amend and --no-verify |
| sounds | Audio notifications (PermissionRequest, Stop) |
| tmux-agent-status | Tmux agent status updates (6 events) |
Skills
| Skill | Description |
|---|---|
| ghostty-config | Configure Ghostty terminal, lookup settings and themes |
| zellij | Read from and write to other zellij panes |
| markdown-formatting | Format/lint markdown files with markdownlint |
Spinner Verbs
Custom spinner verb themes (make claude-verbs THEME=scifi):
- scifi - "Beaming up", "Jumping to lightspeed", "Quantum leaping"...
- peanut - Peanuts-themed verbs
Pi Coding Agent
Pi customizations are symlinked to ~/.pi/agent/ by dotbot.
Extensions
| Extension | Purpose |
|---|---|
| statusline | Footer with directory, git status, model, context, metrics, session |
| git-guardrails | Git safety guardrails for Pi shell commands |
| tmux-agent-status | Tmux agent status updates |
Skills
| Skill | Description |
|---|---|
| brainstorming | Explore intent, requirements, and design before building |
| task | Create Pi task folders for task or feature development |
| writing-plans | Write implementation plans from approved requirements |
| executing-plans | Execute written plans with review checkpoints |
| subagent-driven-development | Execute plans with subagents and review loops |
| verification-before-completion | Require evidence before completion claims |
Keyboard Mappings
Hyper Key modifier
- CapsLock
- CapsLock+cmd
Directional Bindings (CapsLock) w/ Selection (CapsLock+cmd)
- hjkl - VIM arrows
- m - Left one word
- . - Right one word
- n - Home
- p - End
- i - Page Up
- u - Page Down
- cmd+i - Top of page
- cmd+u - End of page
Remappings
- CapsLock+delete - Forward delete
- CapsLock+cmd+delete - Forward delete word
- CapsLock+a - Spaces left
- CapsLock+d - Spaces right
- CapsLock+s - Mission Control
- CapsLock +cmd+s - Show all app windows
Window Launch or Focus
- CapsLock+g - Google Chrome
- CapsLock+c - Visual Studio Code
- CapsLock+; - Ghostty
- CapsLock+f - Slack
- CapsLock+v - Spotify
- CapsLock+r - Notion
Window Manager
Migrated to Raycast Window Manager
Usage
Prerequisites: python, git, zsh
Installation
git clone git@github.com:denolfe/dotfiles.git .dotfiles --recursive
cd .dotfiles
make install
Other Tasks
Files in the repo
- .github
- .vscode
- agents
- aliases
- claude
- eza
- fastfetch
- functions
- ghostty
- git
- glow
- hunk
- iina
- karabiner
- linux
- macos
- node
- nvim
- path
- pi
- scripts
- tmux
- userscripts
- vim
- vscode
- zsh
- .git-blame-ignore-revs
- .gitignore
- .gitmodules
- .markdownlint.jsonc
- CLAUDE.md
- context-bar.gif
- dotbot
- install
- install.conf.yaml
- Makefile
- preview.png
- README.md
- statusline.png
Discussion (0)
Ask about usage, or say what you built with itSign in to join the discussion.
No comments yet. Be the first to say what this is good for.
More harnesses
The job search that runs on your machine. AI job application framework built on Claude Code: evaluate postings, tailor CVs, write cover letters, prep interviews. Fork it and own it.
from vibe coding to agentic engineering - practice makes claude perfect
🌊 The original agent meta-harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
Practical patterns, starters & CLI tools for loop engineering with AI coding agents. Design systems that prompt and orchestrate agents (inspired by Addy Osmani and Boris Cherny). Includes loop-audit, loop-init, loop-cost.
Git. Ship. Done - Core