agentleFS
LaansDoleLaansDole/my-hermes-skills/skills/productivity/oh-my-ghostty/SKILL.md

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

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
  1. Very specific:

    zoxide init order: must come after oh-my-zsh's compinit — end of .zshrc is safe.

    line 73

≈ “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.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

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)

  1. Install what's missing — check first, only install gaps:
    brew list --formula | grep -E "^(bat|eza|zoxide|fastfetch)$"
    brew install bat eza zoxide   # fastfetch too if absent
    Ghostty itself: brew install --cask ghostty. Its CLI is NOT on PATH by default — use the full binary:
    /Applications/Ghostty.app/Contents/MacOS/ghostty
  2. Ghostty config — create ~/.config/ghostty/config if absent:
    # oh-my-ghostty — https://github.com/sudo-conner/oh-my-ghostty
    theme = Catppuccin Frappe
    Validate before declaring success:
    /Applications/Ghostty.app/Contents/MacOS/ghostty +validate-config
    Discover valid theme names with +list-themes | grep -i catppuccin.
  3. zsh block — append to ~/.zshrc as 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 <<<
  4. 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 .zshrc plugins 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 is Catppuccin Frappe (spaces, mixed case). +validate-config catches 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 .zshrc is safe. Before it, completions break.
  • bat paging: alias cat="bat" pager-ifies long output and breaks scripts expecting cat semantics; use bat --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 z plugin to the user's plugins=(...) list: it aliases z to zshz (legacy ~/.z frecency db) and shadows zoxide's z function, sending z <dir> to the wrong project. zoxide is initialized via eval "$(zoxide init zsh)" only.
  • Non-tty test noise: zsh -i -c in 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=never

fastfetch rendering in the test output itself is the positive signal for the startup hook.

Download now (ZIP)

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
What did you use it for? e.g. Reviewing pull requests in a Rails app

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.