Skip to content
Back to search

bama

MarketplaceWorks with Claude CodeGitHub

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.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/daveebbelaar--bama/badge.svg)](/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.

  1. {
  2. "name": "bama",
  3. "owner": {
  4. "name": "Dave Ebbelaar",
  5. "url": "https://github.com/daveebbelaar"
  6. },
  7. "description": "Build any Mac app. Agent skills for native macOS apps with Swift and SwiftUI.",
  8. "plugins": [
  9. {
  10. "name": "bama",
  11. "source": "./",
  12. "description": "Build any Mac app: skills to research, clone, plan, scaffold, design, integrate, optimize, test, and ship native macOS apps with Swift and SwiftUI.",
  13. "category": "development",
  14. "keywords": [
  15. "macos",
  16. "swift",
  17. "swiftui",
  18. "swiftdata",
  19. "liquid-glass",
  20. "computer-use",
  21. "clone",
  22. "performance",
  23. "skills"
  24. ]
  25. }
  26. ]
  27. }
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.

  1. <div align="center">
  2. <picture>
  3. <source media="(prefers-color-scheme: dark)" srcset="docs/assets/banner-dark.png">
  4. <source media="(prefers-color-scheme: light)" srcset="docs/assets/banner-light.png">
  5. <img alt="BAMA: Build Any Mac App" src="docs/assets/banner-light.png" width="860">
  6. </picture>
  7. ### See an app you like. Rebuild it as your own native Mac app.
  8. Agent skills that take a native macOS app from idea to your Dock.<br>
  9. Swift and SwiftUI. Local data. No Xcode GUI.
  10. [![macOS 26+](https://img.shields.io/badge/macOS-26%2B-000000?style=flat-square&logo=apple&logoColor=white)](#requirements)
  11. [![Swift 6.2](https://img.shields.io/badge/Swift-6.2-F05138?style=flat-square&logo=swift&logoColor=white)](#requirements)
  12. [![21 skills](https://img.shields.io/badge/skills-21-5E5CE6?style=flat-square)](#skills)
  13. [![Claude Code plugin](https://img.shields.io/badge/Claude_Code-plugin-D97757?style=flat-square&logo=claude&logoColor=white)](#install)
  14. [![Codex plugin](https://img.shields.io/badge/Codex-plugin-10A37F?style=flat-square)](#install)
  15. [![MIT license](https://img.shields.io/badge/license-MIT-F4C430?style=flat-square)](LICENSE)
  16. **[Quick start](#quick-start) · [How it works](#how-it-works) · [Skills](#skills) · [Specs](#specs) · [Install](#install)**
  17. **On Windows? Use [BAWA: Build Any Windows App](https://github.com/daveebbelaar/bawa) instead.**
  18. </div>
  19. ## Quick start
  20. ```bash
  21. npx skills@latest add daveebbelaar/bama
  22. ```
  23. Then ask your agent:
  24. ```text
  25. Clone my to-do app as a native Mac app.
  26. Screenshot every screen, write the user stories, and build milestone 1.
  27. ```
  28. Not sure where to start? Type `/bama`. It looks at your project and picks the next skill.
  29. ## How it works
  30. <table>
  31. <tr>
  32. <td width="33%" valign="top">
  33. **1. Clone**
  34. Your agent opens the app you like and screenshots every screen. It writes a screen index.
  35. </td>
  36. <td width="33%" valign="top">
  37. **2. Plan**
  38. It turns the screens into user stories with checkable acceptance criteria, in milestones.
  39. </td>
  40. <td width="33%" valign="top">
  41. **3. Build**
  42. It builds one story per commit. Before each commit it snapshots every page in light and dark mode and runs the tests.
  43. </td>
  44. </tr>
  45. </table>
  46. ## Skills
  47. <table>
  48. <tr><th>Stage</th><th>Skill</th><th>What it does</th></tr>
  49. <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>
  50. <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>
  51. <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>
  52. <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>
  53. <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>
  54. <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>
  55. <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>
  56. <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>
  57. <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>
  58. <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>
  59. <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>
  60. <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>
  61. <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>
  62. <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>
  63. <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>
  64. <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>
  65. <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>
  66. <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>
  67. <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>
  68. <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>
  69. <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>
  70. </table>
  71. ## Specs
  72. 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:
  73. ```text
  74. Build the app in window-snapper.md with BAMA.
  75. ```
  76. ## Install
  77. Pick one route per agent. Two routes install every skill twice.
  78. <details open>
  79. <summary><b>Claude Code</b></summary>
  80. ```text
  81. /plugin marketplace add daveebbelaar/bama
  82. /plugin install bama@bama
  83. ```
  84. To get new versions, run this in your shell, then start a new session:
  85. ```bash
  86. claude plugin marketplace update bama
  87. claude plugin update bama@bama
  88. ```
  89. To update on its own: run `/plugin`, open **Marketplaces**, select `bama`, and select **Enable auto-update**.
  90. </details>
  91. <details>
  92. <summary><b>Codex</b></summary>
  93. ```bash
  94. codex plugin marketplace add daveebbelaar/bama
  95. codex plugin add bama@bama
  96. ```
  97. </details>
  98. <details>
  99. <summary><b>Any other agent</b> (Cursor, Gemini CLI, Copilot, and more)</summary>
  100. Uses [skills.sh](https://skills.sh). Install all skills, or one with `--skill`.
  101. ```bash
  102. npx skills@latest add daveebbelaar/bama -a <agent>
  103. npx skills@latest add daveebbelaar/bama --skill=clone
  104. ```
  105. </details>
  106. <details>
  107. <summary><b>By hand</b></summary>
  108. ```bash
  109. git clone https://github.com/daveebbelaar/bama.git
  110. bama/scripts/link-skills.sh # links every skill into ~/.claude/skills and ~/.agents/skills
  111. ```
  112. </details>
  113. ## Requirements
  114. - macOS 26 or later
  115. - Xcode 26 or later, for the Swift 6.2 toolchain (you never open it)
  116. - An agent that supports skills: Claude Code, Codex, Cursor, Gemini CLI
  117. - For `clone` on native apps: computer use (Claude Pro or Max)
  118. ## Credits
  119. - The idea and the "any" promise come from
  120. [REA: Reverse Engineer Anything](https://github.com/morluto/rea) by morluto.
  121. REA showed that an agent can reverse engineer any app. BAMA takes that idea to the Mac.
  122. - Skill format and writing rules follow Matt Pocock's
  123. [skills](https://github.com/mattpocock/skills) and his
  124. `writing-for-agents` skill.
  125. - Works well with [SwiftUI Pro](https://github.com/twostraws/SwiftUI-Agent-Skill)
  126. by Paul Hudson and [SwiftUI Expert](https://github.com/AvdLee/SwiftUI-Agent-Skill)
  127. by Antoine van der Lee.
  128. ## License
  129. [MIT](LICENSE)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.