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.
- Agentic Coding &
obra/superpowersReady: Out-of-the-box integration with Antigravity, Claude Code, and Gemini CLI, pre-loaded withobra/superpowersskills (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 = falseto prevent background agent focus-stealing, fast split navigation), Harness Engineering (harness_init,spec_new, tieredJustfile), isolated Git worktrees for background agents, anduv/ghtriage helpers. - Cloud & AI FDE Toolkit: Pre-configured with
kubectl,kubectx(kx),kubens(kn),k9s,stern,helm,jq,yq,grpcurl,sops,age, interactivefzfKubernetes & 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,
fzffuzzy finding,ripgrep(rg),fd,bat,eza,atuin,htop,watch,direnv, and lazy-loadednvmfor near-instant shell startup. - Enterprise & Managed Environment Safe: Preserves system-provided
/bin/zsh,/etc/zshrc,/usr/local/git, and/usr/local/goprecedence, disables external agent telemetry (SUPERPOWERS_DISABLE_TELEMETRY=1,DISABLE_TELEMETRY=1), and avoids storing plaintext credentials. - Local Customization Hooks: Supports untracked
~/.zshrc.localand~/.gitconfig.localfiles so machine-specific or work-specific settings never pollute the repository.
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.shNote: If you clone the repository to another path (e.g.,
~/projects/dubodots), running./setup.shor./setup_links.shautomatically creates the~/.dotfilessymlink pointing to your checkout directory.
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 |
Configured via setup_agents.sh, agents/AGENTS.md, and shellconfig/agents.sh.
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 --uninstallWhen 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/superpowerswithalways_onbootstrap rules in~/.gemini/config/rules/superpowers.mdand~/.gemini/config/rules/global-engineering.md, plus~/.gemini/skills/and~/.agents/skills/. - Claude Code (
--claude): Symlinked into~/.claude/skills/with~/.claude/CLAUDE.mdand privacy-hardened~/.claude/settings.json(and installsclaude-codevia Homebrew Cask on macOS if not present).
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 |
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 thewta/wts/wtrmhelpers) 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), andgit reflogcover the recovery story.
Defined in shellconfig/kubernetes.sh, shellconfig/agents.sh, and shellconfig/aliases.sh.
| 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 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 |
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 |
Defined in shellconfig/funcs.sh and shellconfig/aliases.sh.
| 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 (rc/config/ghostty/config)
- Font:
MesloLGS NF(size 13) with Nerd Font glyphs for Powerlevel10k. - Focus Protection:
desktop-notifications = falseso background coding agents never interrupt deep work. - Unified
CmdShortcuts (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-aprefix 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).
Herdr (rc/config/herdr/config.toml)
- Theme & Focus:
catppuccintheme withui.toast.delivery = "herdr"(in-app notifications only, preventing OS focus-stealing). - Native Ghostty
CmdParity: Supports bothCtrl-aandCtrl-bprefixes so every native GhosttyCmdshortcut (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 = trueandexperimental.pane_history = trueso Claude Code, Antigravity (agy), and Codex conversations automatically resume across daemon/host restarts. - Aliases:
hd(herdr),hda(herdr session attach),hdl(herdr session list).
Tmux (rc/tmux.conf)
- Prefix:
Ctrl-a(as well as defaultCtrl-b) - Split Panes (preserves current directory):
Prefix + |(horizontal) andPrefix + -(vertical) - Navigate Panes:
Alt + Arrow Keys(no prefix required) - Mouse & Sync Mode: Toggle mouse with
Prefix + m; toggle multi-pane broadcast withPrefix + y - Reload Config:
Prefix + rreloads~/.tmux.conflive - Truecolor & Scrollback: 24-bit truecolor enabled (
Tc) with a 50,000-line history buffer
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~/.zshrcif 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.shto set youruser.nameanduser.email, or add corporate[url]/[http]/ credential helper overrides here.~/.p10k.zsh: Customize your prompt appearance anytime by runningp10k configure.
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