oh-my-ghostty
Skill3 starsChanged 10 days agoMITView on GitHub
Use when setting up or refreshing the oh-my-ghostty terminal stack on macOS - Ghostty config, fastfetch on new-terminal startup, and bat/eza/zoxide aliases for zsh.
- Installs packages
In this repository20 other files it gives its agents.
- AGENTS.mdAGENTS.md
- covidence-full-text-reviewSkill
- covidence-full-text-retrievalSkill
- covidence-screeningSkill
- impeccableSkill
- ilearning-autoadvanceSkill
- oh-my-piSkill
- auditing-worktreesSkill
- camofox-browserSkill
- demo-runbookSkill
- hermes-deepseek-cacheSkill
- i-have-adhdSkill
- memory-uiSkill
- multi-repo-pr-review-merge-roundSkill
- tldrSkill
- writing-reportsSkill
- sci-hub-accessSkill
- slack-mention-watchSkill
- slack-scanSkill
- superpowers-using-superpowersSkill
The file
We split this skill into the rules it gives an agent
1 rule. About 0 are common, 0 are distinctive, and 1 is very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈0
Distinctive · estimate
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 73
zoxide init order: must come after oh-my-zsh's compinit — end of .zshrc is safe.
≈ “Common” is an estimate: at least 1 in 5 of the 372,429 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
oh-my-ghostty
Set up the sudo-conner/oh-my-ghostty terminal stack on macOS: Ghostty theme config, fastfetch on every new terminal, and the bat/eza/zoxide aliases in zsh. Assumes Oh My Zsh + Powerlevel10k are already installed and configured — this skill never touches them (user preference: p10k theme stays as-is).
When to use
- "Set up oh-my-ghostty", "make my terminal like oh-my-ghostty", "add fastfetch on startup", "replace cat/ls/cd with bat/eza/zoxide".
- Refreshing any piece of the stack after a Ghostty upgrade or new machine.
What the repo actually is
The GitHub repo is a blog-style guide, not an installable framework — no script to run. It documents: Ghostty (brew cask), Oh My Zsh, p10k, fastfetch, zsh-syntax-highlighting + zsh-autosuggestions, and three aliases (cat→bat, ls→eza, cd→zoxide). Apply it manually; everything is idempotent.
Setup (macOS, Homebrew)
- Install what's missing — check first, only install gaps:
Ghostty itself:brew list --formula | grep -E "^(bat|eza|zoxide|fastfetch)$" brew install bat eza zoxide # fastfetch too if absentbrew install --cask ghostty. Its CLI is NOT on PATH by default — use the full binary:/Applications/Ghostty.app/Contents/MacOS/ghostty - Ghostty config — create
~/.config/ghostty/configif absent:
Validate before declaring success:# oh-my-ghostty — https://github.com/sudo-conner/oh-my-ghostty theme = Catppuccin Frappe
Discover valid theme names with/Applications/Ghostty.app/Contents/MacOS/ghostty +validate-config+list-themes | grep -i catppuccin. - zsh block — append to
~/.zshrcas a marked block (re-runs replace the block between the markers; never duplicate):# >>> BEGIN OH-MY-GHOSTTY (https://github.com/sudo-conner/oh-my-ghostty) >>> # fastfetch on new terminal startup (skip in nested shells to keep serial/agent terminals clean) if [[ $SHLVL -eq 1 && -o interactive && -x "$(command -v fastfetch)" ]]; then fastfetch fi # zoxide (smarter cd) — must init after compinit eval "$(zoxide init zsh)" # Aliases alias cat="bat --paging=never" alias ls="eza -lao --git-repos --header --icons" alias cd="z" # <<< END OH-MY-GHOSTTY <<< - zsh-syntax-highlighting / zsh-autosuggestions — the repo adds these too, but they are oh-my-zsh plugins in
~/.oh-my-zsh/custom/plugins/, not brew-managed here. If the user's.zshrcplugins array already lists them, skip (do not install brew duplicates).
Gotchas
- Theme name: the repo README says
theme = catppuccin-frappe; Ghostty 1.3.1 rejects it — the built-in name isCatppuccin Frappe(spaces, mixed case).+validate-configcatches this. - fastfetch guard: without
SHLVL -eq 1, fastfetch prints in every nested shell — including agent/serial terminal sessions, polluting tool output. The-x "$(command -v fastfetch)"check keeps shells working if brew package is removed. - zoxide init order: must come after oh-my-zsh's
compinit— end of.zshrcis safe. Before it, completions break. - bat paging:
alias cat="bat"pager-ifies long output and breaks scripts expecting cat semantics; usebat --paging=never. - Alias shadowing: the block appends after any older alias sections, so eza wins over pre-existing
alias ls=...— intended (mention it to the user, don't "fix" it). - Never add oh-my-zsh's
zplugin to the user'splugins=(...)list: it aliasesztozshz(legacy~/.zfrecency db) and shadows zoxide'szfunction, sendingz <dir>to the wrong project. zoxide is initialized viaeval "$(zoxide init zsh)"only. - Non-tty test noise:
zsh -i -cin a pipe shows a gitstatus/p10k "failed to initialize" error — false alarm from the missing tty, not a config problem.
Verification (real shell, not memory)
# config valid
/Applications/Ghostty.app/Contents/MacOS/ghostty +validate-config && echo OK
# aliases + zoxide actually loaded (SHLVL=0 simulates a top-level shell so the
# fastfetch guard fires — proves startup behavior too)
env SHLVL=0 zsh -i -c 'whence -v cd; whence -v ls; whence -v cat'
# expect:
# cd is an alias for z
# ls is an alias for eza -lao --git-repos --header --icons
# cat is an alias for bat --paging=neverfastfetch rendering in the test output itself is the positive signal for the startup hook.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

