Skip to content
dubocPublic

About

.dotfiles for my OSX and Linux setup

Resources

Stars

4 stars

Watchers

1 watching

Forks

Repository files navigation

Console Dotfiles (dubodots)

A modular, cross-platform collection of dotfiles, shell scripts, and terminal configurations designed for Cloud AI Forward Deployed Engineers (FDEs), cloud developers, and agentic terminal power users on macOS and Linux.

Features & Design Principles

  • Agentic Coding & obra/superpowers Ready: Out-of-the-box integration with Antigravity, Claude Code, and Gemini CLI, pre-loaded with obra/superpowers skills (Socratic brainstorming, spec-first planning, RED-GREEN-REFACTOR TDD, subagent-driven development, systematic debugging, and isolated Git worktrees).
  • Mitchell Hashimoto Terminal & Harness Workflow: Incorporates Mitchell Hashimoto's Ghostty configuration (desktop-notifications = false to prevent background agent focus-stealing, fast split navigation), Harness Engineering (harness_init, spec_new, tiered Justfile), isolated Git worktrees for background agents, and uv / gh triage helpers.
  • Cloud & AI FDE Toolkit: Pre-configured with kubectl, kubectx (kx), kubens (kn), k9s, stern, helm, jq, yq, grpcurl, sops, age, interactive fzf Kubernetes & GCP selectors (gcpinfo, gprojf, gctxf, klog, kexec, kpf), and instant Vertex AI Gemini endpoint testing (vertex_ping).
  • Fast Terminal Workflow: Includes Powerlevel10k with instant prompt, fzf fuzzy finding, ripgrep (rg), fd, bat, eza, atuin, htop, watch, direnv, and lazy-loaded nvm for near-instant shell startup.
  • Enterprise & Managed Environment Safe: Preserves system-provided /bin/zsh, /etc/zshrc, /usr/local/git, and /usr/local/go precedence, disables external agent telemetry (SUPERPOWERS_DISABLE_TELEMETRY=1, DISABLE_TELEMETRY=1), and avoids storing plaintext credentials.
  • Local Customization Hooks: Supports untracked ~/.zshrc.local and ~/.gitconfig.local files so machine-specific or work-specific settings never pollute the repository.

Installation

Quick Start

Run the unified setup script (automatically detects macOS or Linux):

# Clone repository to ~/.dotfiles (or any preferred directory)
git clone https://github.com/duboc/dubodots.git "$HOME/.dotfiles"
cd "$HOME/.dotfiles"

# Execute unified setup script
./setup.sh

Note: If you clone the repository to another path (e.g., ~/projects/dubodots), running ./setup.sh or ./setup_links.sh automatically creates the ~/.dotfiles symlink pointing to your checkout directory.

Running Individual Setup Modules

Each setup stage is modular and idempotent, so you can run individual scripts anytime:

Script Description
./setup.sh Full end-to-end base setup for macOS or Linux
./setup_links.sh Creates/updates symlinks in ~, ~/.config/ (Ghostty, Herdr, Git, htop) and removes stale links to configs no longer in the repo
./setup_agents.sh Optional: Installs/configures obra/superpowers, Claude Code (--claude), and/or Antigravity (--antigravity)
./setup_zsh.sh Installs/updates Oh My Zsh, Powerlevel10k, and Zsh plugins
./setup_herdr.sh Installs/updates Herdr agent runtime, links ~/.config/herdr/config.toml, and wires agent session-restore integrations
./setup_tmux.sh Installs/updates Tmux Plugin Manager (tpm) and Tmux plugins
./setup_git_user.sh Configures your Git user.name and user.email in ~/.gitconfig.local
./go_apps.sh Installs Go developer utilities (2fa, benchstat, yaegi) via go install

Agentic Development Workflow (obra/superpowers & Mitchell Hashimoto)

Configured via setup_agents.sh, agents/AGENTS.md, and shellconfig/agents.sh.

1. Optional Multi-Harness obra/superpowers Integration

Agent configurations are opt-in so you can enable only the harnesses permitted on a given machine:

# Configure Claude Code (~/.claude + obra/superpowers)
./setup_agents.sh --claude

# Configure Antigravity & Gemini CLI (~/.gemini + obra/superpowers)
./setup_agents.sh --antigravity

# Configure both
./setup_agents.sh --all

# Remove all installed agent configurations and obra/superpowers
./setup_agents.sh --uninstall

When enabled, ./setup_agents.sh clones obra/superpowers into ~/.local/share/superpowers and wires its 15 core skills (brainstorming, using-git-worktrees, writing-plans, subagent-driven-development, executing-plans, test-driven-development, systematic-debugging, verification-before-completion, dispatching-parallel-agents, etc.) for the selected target(s):

  • Antigravity (--antigravity): Installed as a plugin in ~/.gemini/config/plugins/superpowers with always_on bootstrap rules in ~/.gemini/config/rules/superpowers.md and ~/.gemini/config/rules/global-engineering.md, plus ~/.gemini/skills/ and ~/.agents/skills/.
  • Claude Code (--claude): Symlinked into ~/.claude/skills/ with ~/.claude/CLAUDE.md and privacy-hardened ~/.claude/settings.json (and installs claude-code via Homebrew Cask on macOS if not present).

2. Git Worktrees & Harness Engineering

Inspired by Mitchell Hashimoto's "My AI Adoption Journey" (separate planning from execution, engineer the harness, run background agents in isolated worktrees without desktop notification interruptions):

Command / Alias Usage Description
wta wta <branch> [base] Create an isolated Git worktree in ../<repo>-worktrees/<branch>, copy .env/.envrc, run direnv allow, and cd into it
wts wts Interactive fzf worktree switcher with live git status + git log preview
wtrm wtrm [worktree] Interactive fzf worktree remover + git worktree prune
wtlist wtlist List active Git worktrees (git worktree list)
harness_init harness_init Scaffold AGENTS.md (plus CLAUDE.md & GEMINI.md symlinks), a tiered Justfile (quick / test / lint / fmt / premerge), and docs/plans/ in the current repo
spec_new spec_new <slug> Create a timestamped spec & TDD implementation plan in docs/plans/YYYY-MM-DD-<slug>.md
ghprs / ghissues ghprs / ghissues Interactive fzf GitHub PR checkout and Issue triage browsers with live preview
jx / jls just Run just tasks or just --list

3. Agent Guardrails (global AGENTS.md)

The global agents/AGENTS.md encodes practices from Mitchell Hashimoto and other 2026 agentic-engineering write-ups:

  • Run the fast test tier first (just quick) and reproduce bugs before fixing them.
  • Never reduce test coverage to make a suite pass.
  • Self-review before handoff: re-read the diff, flag new dependencies, weakened tests, and out-of-scope changes.
  • One worktree per concurrent agent, never touch changes you did not make, and no history-destroying Git commands without approval.
  • Land the plane: record remaining work, run all gates, commit, and leave a handoff note; re-read the spec after context compaction.

Why no Jujutsu (jj)? jj was removed on purpose. The agent stack here (Claude Code worktree mode, obra/superpowers, and the wta/wts/wtrm helpers) is Git-worktree based, and jj's colocation, workspace, identity, and pager/editor behavior conflicted with it. Git worktrees plus small commits, Claude Code checkpoints (/rewind), and git reflog cover the recovery story.


Cloud, Kubernetes & AI FDE Workflow

Defined in shellconfig/kubernetes.sh, shellconfig/agents.sh, and shellconfig/aliases.sh.

Google Cloud & Vertex AI FDE Helpers

Command / Alias Usage Description
gcpinfo gcpinfo Print active gcloud config, account, project, region, ADC status, and Kubernetes context
gprojf gprojf Interactive fzf GCP project selector (gcloud projects list $\rightarrow$ gcloud config set project)
gctxf gctxf Interactive fzf gcloud configuration switcher
vertex_ping vertex_ping [prompt] [model] [region] Smoke-test Vertex AI Gemini REST endpoint (generateContent) in the active project to verify IAM, ADC, and VPC-SC
crun_url crun_url [service] Resolve Cloud Run service URL (opens interactive fzf picker if omitted)
gtoken / gidtoken gtoken / gidtoken Print active OAuth2 access token or OIDC identity token
gadc gadc Refresh Google Cloud Application Default Credentials (gcloud auth application-default login)
tf tf terraform shorthand

Kubernetes Context & Interactive Pod Helpers (fzf-Enabled)

All pod helper functions accept an optional pod name substring. If called with no arguments, they open an interactive fzf selector showing live pod status in the current namespace:

Command / Alias Usage Description
k / kx / kn k / kx / kn kubectl, kubectx (switch cluster), kubens (switch namespace)
k9 / h k9 / h Launch k9s terminal UI or helm
klog klog [pod-query] [flags...] Follow logs (-f) for a matching or fzf-selected pod
kexec kexec [pod-query] [cmd...] Execute a command (defaults to /bin/sh) in a matching or fzf-selected pod
kdesc kdesc [pod-query] Run kubectl describe pod on a matching or fzf-selected pod
kpf kpf [pod-query] <local:remote> Port-forward <local:remote> (or single <port>) to a pod
wpod wpod [pod-query] Watch pods matching a query string every 2 seconds
kg / kgall kubectl get / get all Inspect resources in current namespace
kgp / kgpw / kgpa kubectl get pods (-o wide, -A) List pods (standard, wide, or all namespaces)
kgs / kgd / kgn kubectl get svc / deploy / nodes -o wide Inspect services, deployments, or nodes
kge kubectl get events --sort-by=.lastTimestamp View cluster events sorted chronologically
kaf / kdel kubectl apply -f / kubectl delete Apply manifests or delete resources
kroll / krestart kubectl rollout status / restart deploy Track or trigger deployment rollouts
ktop / ktopn kubectl top pods / kubectl top nodes View pod and node resource consumption

Terminal & Developer Utilities

Defined in shellconfig/funcs.sh and shellconfig/aliases.sh.

Shell Functions

Function Usage Description
cdr cdr Jump directly to the root directory of the current Git repository
mkcd mkcd <dir> Create a directory (including parents) and cd into it
fbr fbr Interactive fzf Git branch switcher
fkill fkill [signal] Interactive fzf process finder and killer
whoport whoport <port> Show which process is listening on TCP <port> via lsof
certcheck certcheck <host> [port] Inspect TLS certificate subject, issuer, SANs, and expiry dates for a host
jwtdecode jwtdecode <token> Decode and pretty-print a JWT header and payload locally using base64 + jq
yaml2json yaml2json [file] Convert YAML file or stdin to formatted JSON via yq
json2yaml json2yaml [file] Convert JSON file or stdin to YAML via yq
qfind qfind <pattern> Fast file search by name (uses fd when available, falls back to find)
extract extract <archive> Universal archive extractor (.tar.gz, .tar.xz, .tar.zst, .zip, .7z, etc.)
scppath scppath <file> Print full user@ip:/abs/path string ready for scp
weather weather [city] Display terminal weather forecast via wttr.in

Ghostty, Herdr & Tmux Configuration

  • Font: MesloLGS NF (size 13) with Nerd Font glyphs for Powerlevel10k.
  • Focus Protection: desktop-notifications = false so background coding agents never interrupt deep work.
  • Unified Cmd Shortcuts (Herdr, Tmux & Plain Ghostty): Cmd+D (split right), Cmd+Shift+D (split down), Cmd+[ / Cmd+] (previous/next split), Cmd+Opt+Arrow (directional split focus), Cmd+Shift+Enter (zoom current split), Cmd+T (new tab), Cmd+W (close pane), Cmd+Shift+[ / ] (previous/next tab), Cmd+1..9 (switch tab), Cmd+N (new workspace/window), Cmd+Shift+W (close workspace/window), Cmd+\`` / Cmd+Shift+`(next/previous workspace or window),Cmd+G(Go-To agent/workspace picker), andCmd+B(toggle sidebar) sendCtrl-a prefix sequences inside Herdr/Tmux and automatically fall back to Ghostty's native AppleScript actions (Ghostty.sdef`) when in a plain Zsh shell outside Herdr/Tmux.
  • Outer Window Fallbacks: Opt+N (new Ghostty window), Opt+Shift+T (new Ghostty tab), Opt+Shift+W (close Ghostty window), Opt+D / Opt+Shift+D (native Ghostty splits).
  • Theme & Focus: catppuccin theme with ui.toast.delivery = "herdr" (in-app notifications only, preventing OS focus-stealing).
  • Native Ghostty Cmd Parity: Supports both Ctrl-a and Ctrl-b prefixes so every native Ghostty Cmd shortcut (Cmd+D, Cmd+Shift+D, Cmd+[/], Cmd+Shift+Enter, Cmd+T, Cmd+W, Cmd+Shift+[/], Cmd+1..9, Cmd+N, Cmd+Shift+W, Cmd+\``, Cmd+G, Cmd+B`) controls Herdr directly.
  • Agent Session & Screen Persistence: Enables session.resume_agents_on_restore = true and experimental.pane_history = true so Claude Code, Antigravity (agy), and Codex conversations automatically resume across daemon/host restarts.
  • Aliases: hd (herdr), hda (herdr session attach), hdl (herdr session list).
  • Prefix: Ctrl-a (as well as default Ctrl-b)
  • Split Panes (preserves current directory): Prefix + | (horizontal) and Prefix + - (vertical)
  • Navigate Panes: Alt + Arrow Keys (no prefix required)
  • Mouse & Sync Mode: Toggle mouse with Prefix + m; toggle multi-pane broadcast with Prefix + y
  • Reload Config: Prefix + r reloads ~/.tmux.conf live
  • Truecolor & Scrollback: 24-bit truecolor enabled (Tc) with a 50,000-line history buffer

Local & Machine-Specific Customization

To keep this repository clean and safe to share publicly, machine-specific or corporate settings are loaded from untracked local files:

  • ~/.zshrc.local: Automatically sourced at the end of ~/.zshrc if present. Use this for private environment variables, internal aliases, or custom PATH entries.
  • ~/.gitconfig.local: Included at the end of ~/.gitconfig. Run ./setup_git_user.sh to set your user.name and user.email, or add corporate [url] / [http] / credential helper overrides here.
  • ~/.p10k.zsh: Customize your prompt appearance anytime by running p10k configure.

File & Directory Structure

dubodots/
├── agents/              # Global agent instructions (AGENTS.md) & Claude Code settings
├── bin/                 # Helper scripts and utilities added to $PATH
├── completion/          # Shell completion scripts for Zsh & Bash (kubectx, kubens)
├── fonts/               # Monospaced Nerd Fonts (MesloLGS NF, Monaco NF, etc.)
├── rc/                  # Application runtime configs symlinked into $HOME (~/.zshrc, ~/.tmux.conf, etc.)
│   └── config/          # Sub-configurations symlinked into ~/.config/ (ghostty, herdr, git, htop)
├── shellconfig/         # Shared shell configuration modules for Zsh and Bash
│   ├── agents.sh        # Agentic workflows (worktrees, harness_init, spec_new) & Cloud AI FDE helpers
│   ├── aliases.sh       # Cross-platform Git, cloud, network, and navigation aliases
│   ├── aliases_mac.sh   # macOS-specific aliases
│   ├── exports.sh       # PATH, environment variables, and tool bindings
│   ├── funcs.sh         # Developer & cloud utility functions
│   ├── kubernetes.sh    # Kubernetes / kubectl / fzf pod helpers and aliases
│   └── shellrc.sh       # Shared entry point for Bash/Zsh
├── Brewfile             # Core Homebrew CLI formulae for macOS
├── Brewfile-casks-store # Optional macOS GUI applications (Homebrew Casks & Mac App Store)
├── go_apps.sh           # Go developer binaries installer (go install)
├── osx_prefs.sh         # macOS user defaults and productivity tweaks
├── setup.sh             # Unified entry point script (auto-detects OS & architecture)
├── setup_agents.sh      # obra/superpowers & AI coding agent configurator
├── setup_git_user.sh    # Interactive Git identity configuration script (~/.gitconfig.local)
├── setup_links.sh       # Symlink generator for dotfiles, ~/.config, and Ghostty
├── setup_mac.sh         # macOS orchestration pipeline
├── setup_linux.sh       # Linux orchestration pipeline
├── setup_herdr.sh       # Herdr agent runtime & integration setup
├── setup_tmux.sh        # Tmux & TPM plugin setup
└── setup_zsh.sh         # Oh My Zsh, Powerlevel10k, and Zsh plugin installer

About

.dotfiles for my OSX and Linux setup

Resources

Stars

4 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages