PluginPartly tested (needs an account)
Build your own native Mac app
BAMA: Build Any Mac App
Free MIT skills that plan, design, build and test a native Mac app in Swift from your idea or app screenshots, without opening Xcode yourself.
- Works with
- Claude Code, Codex CLI, Gemini CLI
- Good for
- Build an app, Graphic designers
What it does
BAMA is a set of 21 skills that walks your assistant through making a real Mac app, the kind that sits in your Dock, without you learning Swift or opening Apple's developer app. It works in stages: start, plan, code, design and ship.
You can start from an idea, and it writes a one-page brief and a list of features with checks for each one. Or you can start from an app you already use: it takes screenshots of each screen and plans your own version from them. It then builds the app one feature at a time, takes light and dark screenshots of every page and runs tests before each saved step.
The repo also includes 12 ready plans for small Mac utilities, such as a window snapper, a launcher or clipboard history. Copy one into an empty folder and ask your assistant to build it.
Example prompts
- "/bama"
- "Build the app in window-snapper.md with BAMA."
- "Turn my idea for a habit tracker into an app brief, then build milestone 1."
- "Give my app a Liquid Glass icon and check it in light and dark mode."
How to install
/plugin marketplace add daveebbelaar/bama/plugin install bama@bamaHow to use it
Type /bama in an empty or existing app folder and it picks the next step, or ask for example: "Build the app in window-snapper.md with BAMA."
Check it works
Run /plugin in Claude Code and check that bama is listed, then type /bama. It should look at your folder and suggest the next skill.
Common problems
- Skills appear twice — you installed through more than one route; the README says to pick one route per assistant — https://github.com/daveebbelaar/bama/blob/639893c397278256f1ae204dd8f837eb82bd6527/README.md
- The build fails on an older Mac — BAMA needs macOS 26 and Xcode 26 for the Swift 6.2 toolchain — https://github.com/daveebbelaar/bama/blob/639893c397278256f1ae204dd8f837eb82bd6527/skills/start/new-mac-app/template/Package.swift
- Cloning a native app does nothing — the clone skill needs computer use (Claude Pro or Max); in Claude Code turn it on with
/mcp, thencomputer-use, then Enable — https://github.com/daveebbelaar/bama/blob/639893c397278256f1ae204dd8f837eb82bd6527/skills/plan/clone/SKILL.md
Other assistants
- Codex:
codex plugin marketplace add daveebbelaar/bamathencodex plugin add bama@bama— https://github.com/daveebbelaar/bama/blob/639893c397278256f1ae204dd8f837eb82bd6527/README.md - Gemini CLI: the README lists Gemini CLI only under "Any other agent", with the skills.sh route
npx skills@latest add daveebbelaar/bama -a <agent>; for Gemini CLI the agent name isgemini-cli. That is the only route for Gemini CLI, and BAMA is not in the Gemini extensions gallery — https://github.com/daveebbelaar/bama/blob/639893c397278256f1ae204dd8f837eb82bd6527/README.md - On Windows: the README points to a separate project, BAWA (Build Any Windows App) — https://github.com/daveebbelaar/bama/blob/639893c397278256f1ae204dd8f837eb82bd6527/README.md
What to watch out for
- Runs shell commands on your Mac: swift build, then build.sh copies the app into ~/Applications and signs it with your Apple Development certificate if one is found (ad hoc otherwise). improve-loop and the build steps make one git commit per story
- The clone skill screenshots every screen, menu and settings pane of another app. Copying someone else's app design or brand may break its terms or copyright, so use it for your own ideas. The skill itself says to take no text, logo or icon from the app ("rebuilding for personal use is fine, copying a brand is not") and to keep the screenshots out of public repos
- For native apps the clone skill uses Claude's computer use, which needs a Pro or Max plan and the Accessibility and Screen Recording permissions, and can see and click your screen. It is told to look and not change anything; use a demo account or sample data
- The research skill starts several sub-agents in parallel that search the web and save notes to docs/research/
- Needs macOS 26 or later and Xcode 26 or later (a large download) for the Swift 6.2 toolchain: the app template sets swift-tools-version 6.2 and platforms .macOS(.v26). It does not work on Windows
- The optional agent-cli skill adds a command line and an MCP server to the app you build, so Claude Code, Codex and scripts can control that app
- No release yet: plugin.json stays at 1.0.0 until the first release and main changes often
Licence and author
- Licence
- MIT
- Author
- Dave Ebbelaar (daveebbelaar)
- Source code
- github.com/daveebbelaar/bama
How we tested it
We installed it on an empty test computer on 3 Nov 2026. Partly tested: installed in a clean test system, but its main features need an account or key we did not use.
Technical details of the test
- Date
- 3 Nov 2026
- Method
- Reviewed by our team against the repository, its README and docs.
Checked again on 3 Nov 2026
Alternatives
- Planning with Files — keeps a written plan for any project, not only Mac apps
- Superpowers — general step-by-step build workflows for any kind of software
- Expo Skills — builds phone apps instead of Mac apps
FAQ
- Q: Do I need to know Swift? A: No. The skills write and test the Swift code; you describe what you want and check the screenshots.
- Q: Does it work on Windows? A: No. It builds native macOS apps and needs a Mac with macOS 26.
- Q: Can I copy an app I like? A: Use the clone skill to learn from an app's layout for your own app. Do not copy its name, text, logo, icons or brand.
- Q: Does it cost money? A: The skills are free (MIT). You pay only for your assistant plan; computer use needs Claude Pro or Max.
Sources
- github.com/daveebbelaar/bama
- github.com/daveebbelaar/bama/tree/639893c397278256f1ae204dd8f837eb82bd6527
- github.com/daveebbelaar/bama/blob/639893c397278256f1ae204dd8f837eb82bd6527/README.md
- github.com/daveebbelaar/bama/blob/639893c397278256f1ae204dd8f837eb82bd6527/.claude-plugin/plugin.json
- github.com/daveebbelaar/bama/blob/639893c397278256f1ae204dd8f837eb82bd6527/skills/plan/clone/SKILL.md
- github.com/daveebbelaar/bama/blob/639893c397278256f1ae204dd8f837eb82bd6527/skills/plan/research/SKILL.md
- github.com/daveebbelaar/bama/blob/639893c397278256f1ae204dd8f837eb82bd6527/skills/start/new-mac-app/template/Package.swift
- github.com/daveebbelaar/bama/blob/639893c397278256f1ae204dd8f837eb82bd6527/skills/start/new-mac-app/template/build.sh