# Bama

Build any Mac app.

- Repository: https://github.com/daveebbelaar/bama (1284 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add daveebbelaar/bama --skill bama -g -a claude-code -y`
Codex: `npx skills add daveebbelaar/bama --skill bama -g -a codex -y`
Cursor: `npx skills add daveebbelaar/bama --skill bama -g -a cursor -y`
Gemini CLI: `npx skills add daveebbelaar/bama --skill bama -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add daveebbelaar/bama`

## Description

Build any Mac app. Start here to pick the next skill for a native macOS app.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Build any Mac app

Find where the user is on the path below, then call the Skill tool with the
skill for that step. One skill per call.

```text
idea -> research -> clone (optional) -> app-brief -> user-stories -> new-mac-app
     -> mac-design + design-system + app-icon -> improve-loop (ux, code, design, verify, commit) -> repeat
```

Pick the app's name first (app-brief, step 1) and create
`<parent>/<AppName>/docs/` before research, so every skill writes into the
same folder. Design comes right after the scaffold: tokens from the first
view, and the real icon in every snapshot.

## Plan

| The user has | Skill |
| --- | --- |
| A vague idea, or asks "what should I build" | `research`, then `app-brief` |
| An app they want to replace or rebuild | `clone` |
| A brief or a screen index, no backlog | `user-stories` |
| A spec from BAMA's `specs/` folder | `app-brief` (it copies the spec) |

## Build

| The user wants to | Skill |
| --- | --- |
| Start a new project | `new-mac-app` |
| Write or fix Swift and SwiftUI code | `swift-swiftui` |
| Hook into macOS: hotkeys, menu bar, windows, screen capture, Shortcuts | `os-integrations` |
| Make it fast: hangs, stutter, GPU, video, memory | `performance` |
| Let Claude Code, Codex, or scripts drive the app: a CLI, an MCP server | `agent-cli` |
| Refactor, clean up, or check the code as it grows | `improve-architecture` |

## Design

The rest: https://github.com/daveebbelaar/bama/blob/HEAD/skills/start/bama/SKILL.md