Sandbox
@denolfe/dotfiles

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.

87 stars7 forksShellUpdated 11d ago
Who it's for

Builders who want their Claude Code setup, shell, and terminal behavior kept in one dotfiles repo.

What it delivers

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

  1. 1Run
    git clone git@github.com:denolfe/dotfiles.git .dotfiles --recursive
    cd .dotfiles
    make install

README

denolfe's dotfiles

Actions Status Powered by dotbot

Personal dotfiles configuration

Image

ComponentToolConfig
InstallationDotbotinstall.conf.yaml
TerminalGhosttyconfig
PromptPowerlevel10kcustomizations, config
.zshrcoh-my-zsh.zshrc
Global Key Rebinds, Hyper Key, App FocusKarabinerkarabiner.ts
Claude AI AgentClaude Codeclaude/
Pi AI AgentPipi/

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, always cd /path && git <cmd>

Statusline

  • Directory, git branch, PR#, staged/modified/untracked counts, model name, context % gradient bar
Statusline Statusline

Slash Commands

CommandDescription
/taskCreate task folder with 1-TASK.md, option to brainstorm 2-DESIGN.md
/implement-planExecute PLAN.md with subagent-driven dev and code review between tasks
/pr createCreate PR from template, architecture-focused with mermaid diagrams
/pr updateUpdate 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

Local

PluginPurpose
auto-approveAuto-approves compound bash commands when each part is allowed
git-guardrailsBlocks git add -A/., prompts for --amend and --no-verify
soundsAudio notifications (PermissionRequest, Stop)
tmux-agent-statusTmux agent status updates (6 events)

Skills

SkillDescription
ghostty-configConfigure Ghostty terminal, lookup settings and themes
zellijRead from and write to other zellij panes
markdown-formattingFormat/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

ExtensionPurpose
statuslineFooter with directory, git status, model, context, metrics, session
git-guardrailsGit safety guardrails for Pi shell commands
tmux-agent-statusTmux agent status updates

Skills

SkillDescription
brainstormingExplore intent, requirements, and design before building
taskCreate Pi task folders for task or feature development
writing-plansWrite implementation plans from approved requirements
executing-plansExecute written plans with review checkpoints
subagent-driven-developmentExecute plans with subagents and review loops
verification-before-completionRequire 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

See Makefile

Files in the repo

Repository payload39 top-level entries
  • .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 it

Sign in to join the discussion.

No comments yet. Be the first to say what this is good for.

More harnesses

affaan-m/
ECC
affaan-m/ECCHarnesses

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

258k

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.

42k
ruvnet/rufloHarnesses

🌊 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

72k

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.

11k