gitwtfhub

wtf is prompt-mac?

dunglas/prompt-mac — explained in plain English

Analysis updated 2026-05-18

53ShellAudience · developerComplexity · 2/5Setup · easy

TL;DR

A one-command setup script that turns a fresh Apple Silicon Mac into a terminal and tool environment built around AI coding agents.

Mindmap

mindmap
  root((repo))
    What it does
      One-shot Mac setup
      AI-agent tuned tools
    Tech stack
      Shell
      Zsh
      Homebrew
    Use cases
      New Mac bootstrap
      Modern CLI swap
    Audience
      Developers
      AI agent users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Bootstrap a new Apple Silicon Mac with a terminal and CLI toolset tuned for AI coding agents

REASON 2

Replace default shell commands with faster modern tools like eza, bat, fd, and ripgrep in one step

REASON 3

Run and monitor multiple AI coding agents in parallel using the bundled cmux terminal manager

What's in the stack?

ShellZshHomebrew

How it stacks up

dunglas/prompt-macalirezarezvani/claude-code-github-workflownelsonwerd/idea-to-ship-skills
Stars535354
LanguageShellShellShell
Last pushed2026-03-02
MaintenanceMaintained
Setup difficultyeasymoderatemoderate
Complexity2/53/53/5
Audiencedeveloperdevelopervibe coder

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 5min

Apple Silicon Macs only, running the installer changes shell defaults and symlinks config files.

Wtf does this do

prompt-mac is a single command script that turns a fresh Apple Silicon Mac into a development setup built specifically around working with AI coding agents. Created by Kevin Dunglas, the author of several open-source developer tools, it installs a curated set of CLI tools, apps, and editor configurations rather than a generic all-purpose dotfiles setup. Running the script is as simple as pasting one curl command into the stock terminal. It is idempotent, meaning you can run it again later to pick up new changes to its package list or configuration files, and anything already installed is skipped safely. You can also clone the repository and run the install script by hand if you would rather review the code first, though the configuration files are symlinked back into the cloned folder, so that folder needs to stay in place afterward. The philosophy behind the project favors working with macOS defaults instead of overriding them (Safari, Finder, and Spotlight are left untouched), staying minimal rather than shipping thousands of lines of shell configuration, and treating AI coding agents as a first-class part of the setup so their token usage stays under control. The same set of modern command-line tools is meant to feel identical whether you are in a standalone terminal or inside an editor's integrated terminal. Out of the box it configures the Ghostty terminal with GPU acceleration and a quake-style drop-down window, the cmux terminal manager for running multiple AI agents side by side, the starship prompt, and a zsh setup with fast plugin loading. Familiar commands are quietly swapped for faster modern equivalents: ls becomes eza, cat becomes bat, find becomes fd, grep becomes ripgrep, cd becomes zoxide, and vi becomes neovim. Vim-style modal editing is wired into the shell itself, into neovim as the default editor, and into VS Code through a pre-installed Vim extension. On the AI side, the setup includes a tool the README calls a token killer, which compresses shell command output by 60 to 90 percent before it reaches the Claude Code agent, alongside the official Claude desktop app, aimed at keeping API costs and context windows manageable when running heavy agent workloads.

Yoink these prompts

Prompt 1
Walk me through what the prompt-mac install script changes on my Mac before I run it
Prompt 2
Explain what the rtk token killer tool does and why it matters for AI coding agent costs
Prompt 3
Help me customize the Brewfile in prompt-mac instead of using the default one-liner install

Frequently asked questions

wtf is prompt-mac?

A one-command setup script that turns a fresh Apple Silicon Mac into a terminal and tool environment built around AI coding agents.

What language is prompt-mac written in?

Mainly Shell. The stack also includes Shell, Zsh, Homebrew.

How hard is prompt-mac to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is prompt-mac for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.