bama
Build any Mac app. Agent skills for native macOS apps with Swift and SwiftUI.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/daveebbelaar--bama)HTML
<a href="/listings/daveebbelaar--bama"><img src="/api/listings/daveebbelaar--bama/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
npx skills@latest add daveebbelaar/bama
Then ask your agent:
Clone my to-do app as a native Mac app. Screenshot every screen, write the user stories, and build milestone 1.
Not sure where to start? Type `/bama`. It looks at your project and picks the next skill.
<sub>Prompts like this are faster to say than to type. [Glaido](https://go.glaido.com/d4uhYE6) turns your voice into a clean prompt right inside Claude Code, Codex, or any other app, so you never leave the flow. We make Glaido, so we are biased. It has a free plan.</sub>
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
.claude-plugin/marketplace.json · Manifest · 27 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- {
- "name": "bama",
- "owner": {
- "name": "Dave Ebbelaar",
- "url": "https://github.com/daveebbelaar"
- },
- "description": "Build any Mac app. Agent skills for native macOS apps with Swift and SwiftUI.",
- "plugins": [
- {
- "name": "bama",
- "source": "./",
- "description": "Build any Mac app: skills to research, clone, plan, scaffold, design, integrate, optimize, test, and ship native macOS apps with Swift and SwiftUI.",
- "category": "development",
- "keywords": [
- "macos",
- "swift",
- "swiftui",
- "swiftdata",
- "liquid-glass",
- "computer-use",
- "clone",
- "performance",
- "skills"
- ]
- }
- ]
- }
README.md · README · 181 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- <div align="center">
- <picture>
- <source media="(prefers-color-scheme: dark)" srcset="docs/assets/banner-dark.png">
- <source media="(prefers-color-scheme: light)" srcset="docs/assets/banner-light.png">
- <img alt="BAMA: Build Any Mac App" src="docs/assets/banner-light.png" width="860">
- </picture>
- ### See an app you like. Rebuild it as your own native Mac app.
- Agent skills that take a native macOS app from idea to your Dock.<br>
- Swift and SwiftUI. Local data. No Xcode GUI.
- [](#requirements)
- [](#requirements)
- [](#skills)
- [](#install)
- [](#install)
- [](LICENSE)
- **[Quick start](#quick-start) · [How it works](#how-it-works) · [Skills](#skills) · [Specs](#specs) · [Install](#install)**
- **On Windows? Use [BAWA: Build Any Windows App](https://github.com/daveebbelaar/bawa) instead.**
- </div>
- ## Quick start
- ```bash
- npx skills@latest add daveebbelaar/bama
- ```
- Then ask your agent:
- ```text
- Clone my to-do app as a native Mac app.
- Screenshot every screen, write the user stories, and build milestone 1.
- ```
- Not sure where to start? Type `/bama`. It looks at your project and picks the next skill.
- ## How it works
- <table>
- <tr>
- <td width="33%" valign="top">
- **1. Clone**
- Your agent opens the app you like and screenshots every screen. It writes a screen index.
- </td>
- <td width="33%" valign="top">
- **2. Plan**
- It turns the screens into user stories with checkable acceptance criteria, in milestones.
- </td>
- <td width="33%" valign="top">
- **3. Build**
- It builds one story per commit. Before each commit it snapshots every page in light and dark mode and runs the tests.
- </td>
- </tr>
- </table>
- ## Skills
- <table>
- <tr><th>Stage</th><th>Skill</th><th>What it does</th></tr>
- <tr><td rowspan="3" valign="top"><b>Start</b></td><td nowrap><a href="skills/start/bama/SKILL.md"><samp>bama</samp></a></td><td>Router: finds where you are and calls the right skill</td></tr>
- <tr><td nowrap><a href="skills/start/app-brief/SKILL.md"><samp>app-brief</samp></a></td><td>Turns an idea into a one-page brief</td></tr>
- <tr><td nowrap><a href="skills/start/new-mac-app/SKILL.md"><samp>new-mac-app</samp></a></td><td>A working app from a template: Swift package, SwiftData, build script, snapshot mode, git</td></tr>
- <tr><td rowspan="3" valign="top"><b>Plan</b></td><td nowrap><a href="skills/plan/research/SKILL.md"><samp>research</samp></a></td><td>Parallel researcher agents: market, users, features, design, macOS APIs</td></tr>
- <tr><td nowrap><a href="skills/plan/clone/SKILL.md"><samp>clone</samp></a></td><td>Screenshots every screen of any app with computer use or a browser, writes a screen index</td></tr>
- <tr><td nowrap><a href="skills/plan/user-stories/SKILL.md"><samp>user-stories</samp></a></td><td>A backlog with checkable acceptance criteria, in milestones</td></tr>
- <tr><td rowspan="5" valign="top"><b>Code</b></td><td nowrap><a href="skills/code/swift-swiftui/SKILL.md"><samp>swift-swiftui</samp></a></td><td>Swift 6 concurrency, state, SwiftData, AppKit bridges, compiler errors</td></tr>
- <tr><td nowrap><a href="skills/code/os-integrations/SKILL.md"><samp>os-integrations</samp></a></td><td>Global hotkeys, menu bar, floating panels, window control, screen capture, Shortcuts, URL schemes, CLI, permissions</td></tr>
- <tr><td nowrap><a href="skills/code/performance/SKILL.md"><samp>performance</samp></a></td><td>Measure, then fix: main thread, GPU compositing, images, Instruments from the command line</td></tr>
- <tr><td nowrap><a href="skills/code/improve-architecture/SKILL.md"><samp>improve-architecture</samp></a></td><td>Finds hot spots as the app grows and refactors one step per commit, with behavior proven unchanged</td></tr>
- <tr><td nowrap><a href="skills/code/agent-cli/SKILL.md"><samp>agent-cli</samp></a></td><td>Optional: a command line and MCP server, so Claude Code, Codex, and scripts can drive your app</td></tr>
- <tr><td rowspan="7" valign="top"><b>Design</b></td><td nowrap><a href="skills/design/ux-design/SKILL.md"><samp>ux-design</samp></a></td><td>Names, flow, where each feature opens (inline, popover, sheet, window), words, and accessibility, before code</td></tr>
- <tr><td nowrap><a href="skills/design/mac-design/SKILL.md"><samp>mac-design</samp></a></td><td>Liquid Glass, layout, toolbars, menus, keyboard, type, dark mode</td></tr>
- <tr><td nowrap><a href="skills/design/design-system/SKILL.md"><samp>design-system</samp></a></td><td>Native look with an accent color people pick in Settings, then one set of tokens and one rules page</td></tr>
- <tr><td nowrap><a href="skills/design/layout-grid/SKILL.md"><samp>layout-grid</samp></a></td><td>A 4 pt grid with checks that fail on misalignment: a code lint, a layout probe in snapshot mode, and a grid overlay</td></tr>
- <tr><td nowrap><a href="skills/design/design-kit/SKILL.md"><samp>design-kit</samp></a></td><td>Your own parts, not Apple's: three token layers, type, an icon set, every part in every state, custom window chrome, and a parts gallery</td></tr>
- <tr><td nowrap><a href="skills/design/design-from-app/SKILL.md"><samp>design-from-app</samp></a></td><td>Rebuilds the look of an app you like from its screenshots: measures sizes, type, and colors, then compares pixel by pixel until it matches</td></tr>
- <tr><td nowrap><a href="skills/design/app-icon/SKILL.md"><samp>app-icon</samp></a></td><td>A Liquid Glass icon written as an Icon Composer file, checked in every look</td></tr>
- <tr><td rowspan="3" valign="top"><b>Ship</b></td><td nowrap><a href="skills/ship/build-and-verify/SKILL.md"><samp>build-and-verify</samp></a></td><td>Build, install, snapshot every page in light and dark, look at them</td></tr>
- <tr><td nowrap><a href="skills/ship/test-mac-app/SKILL.md"><samp>test-mac-app</samp></a></td><td>Swift Testing, an in-app self-test, a debug bridge an agent can drive</td></tr>
- <tr><td nowrap><a href="skills/ship/improve-loop/SKILL.md"><samp>improve-loop</samp></a></td><td>Works through the backlog one story per commit until a milestone is done</td></tr>
- </table>
- ## Specs
- Not sure what to build? [specs/](specs/) has 12 build plans for small Mac apps: a window snapper, a window switcher, a launcher, clipboard history, screenshots, a screen recorder, and more. I took them apart from Onyx, my own menu bar app. Copy one into an empty folder and tell your agent:
- ```text
- Build the app in window-snapper.md with BAMA.
- ```
- ## Install
- Pick one route per agent. Two routes install every skill twice.
- <details open>
- <summary><b>Claude Code</b></summary>
- ```text
- /plugin marketplace add daveebbelaar/bama
- /plugin install bama@bama
- ```
- To get new versions, run this in your shell, then start a new session:
- ```bash
- claude plugin marketplace update bama
- claude plugin update bama@bama
- ```
- To update on its own: run `/plugin`, open **Marketplaces**, select `bama`, and select **Enable auto-update**.
- </details>
- <details>
- <summary><b>Codex</b></summary>
- ```bash
- codex plugin marketplace add daveebbelaar/bama
- codex plugin add bama@bama
- ```
- </details>
- <details>
- <summary><b>Any other agent</b> (Cursor, Gemini CLI, Copilot, and more)</summary>
- Uses [skills.sh](https://skills.sh). Install all skills, or one with `--skill`.
- ```bash
- npx skills@latest add daveebbelaar/bama -a <agent>
- npx skills@latest add daveebbelaar/bama --skill=clone
- ```
- </details>
- <details>
- <summary><b>By hand</b></summary>
- ```bash
- git clone https://github.com/daveebbelaar/bama.git
- bama/scripts/link-skills.sh # links every skill into ~/.claude/skills and ~/.agents/skills
- ```
- </details>
- ## Requirements
- - macOS 26 or later
- - Xcode 26 or later, for the Swift 6.2 toolchain (you never open it)
- - An agent that supports skills: Claude Code, Codex, Cursor, Gemini CLI
- - For `clone` on native apps: computer use (Claude Pro or Max)
- ## Credits
- - The idea and the "any" promise come from
- [REA: Reverse Engineer Anything](https://github.com/morluto/rea) by morluto.
- REA showed that an agent can reverse engineer any app. BAMA takes that idea to the Mac.
- - Skill format and writing rules follow Matt Pocock's
- [skills](https://github.com/mattpocock/skills) and his
- `writing-for-agents` skill.
- - Works well with [SwiftUI Pro](https://github.com/twostraws/SwiftUI-Agent-Skill)
- by Paul Hudson and [SwiftUI Expert](https://github.com/AvdLee/SwiftUI-Agent-Skill)
- by Antoine van der Lee.
- ## License
- [MIT](LICENSE)
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.