BAMA: Build Any Mac App
Agent skills that take a native macOS app from idea to your Dock, using Swift and SwiftUI with no Xcode GUI.
- Source repo
- daveebbelaar/bama
- Stars
- ★ 1.9k
- Last updated
- 16d ago
- License
- MIT
- Primary language
- Swift
- FA score
- 61/100 · Some gaps
At a glance
- How it runs
- Works with
- Portable with changesCodex · Claude Code
- Cost
- Free software; you pay for model usage
- Setup effort
- Medium · a few setup steps
- You'll need
- Typical use
- An indie developer likes a to-do or notes app and wants a native Mac version they own outright
- Not a fit if
- Teams still on macOS 15 or earlier
- Developers who want one cross-platform codebase instead of a native Mac app
- Users without a Claude Pro/Max plan who need to clone a native app's screens
- Maintenance
- Commits in the last 30 dayslast commit 2026-11-05latest release bama--v1.1.1 (2026-11-05)+17.1 ★/day over 7 days
- Source review
- 61/100 · Some gaps
What does this agent do, and when should you use it?
BAMA is a set of agent skills for building native macOS apps. The repository ships 21 skills across five stages — Start, Plan, Code, Design and Ship — delivered as a Claude Code plugin, a Codex plugin, or a skills.sh package. A coding agent screenshots every screen of a target app with computer use or a browser, turns those screens into user stories with checkable acceptance criteria, then builds one story per commit in Swift 6.2 and SwiftUI with local SwiftData storage. Dedicated skills cover concurrency, OS integrations such as global hotkeys and menu bar items, performance work, a 4 pt layout grid with lint and snapshot probes, Liquid Glass design tokens and Icon Composer icons, and pre-commit light/dark snapshot verification. The repo also bundles 12 build plans for small Mac apps in specs/ that you can copy into an empty folder and hand to your agent. Runtime requirements are macOS 26 and the Xcode 26 toolchain, which you never open directly.
Each skill is a SKILL.md instruction file the agent loads on demand. clone captures every screen of the target app and writes a screen index; research fans out parallel researcher agents over market, users, features, design and macOS APIs; user-stories produces a milestone backlog with checkable acceptance criteria; new-mac-app scaffolds a Swift package with SwiftData, a build script, snapshot mode and git. Coding skills — swift-swiftui, os-integrations, performance, improve-architecture, agent-cli — cover concurrency, global hotkeys, menu bar and floating panels, main-thread and GPU work measured with command-line Instruments, and an optional CLI plus MCP server. Design skills enforce a 4 pt grid, token layers and pixel comparison against reference screenshots. build-and-verify and test-mac-app build, install, snapshot every page in light and dark mode, and run Swift Testing plus an agent-drivable debug bridge before each commit.
- An indie developer likes a to-do or notes app and wants a native Mac version they own outright
- You need a fresh SwiftUI front end for an existing Mac utility and want the agent to compile and verify screenshots without ever opening Xcode
- You want to start from an empty folder by copying a plan such as window-snapper.md from specs/ and letting the agent scaffold a working app
- A product manager wants screenshots turned into a milestone backlog with acceptance criteria, then implemented story by story
- A team wants light and dark UI snapshots plus unit tests generated before every commit as a regression signal
- You want your Mac app to expose a command line and MCP server so Claude Code, Codex or scripts can drive it
Key setup facts
Pulled from the install and usage notes below. The project README has the current values.
- Install / run
npx skills@latest add daveebbelaar/bama -a <agent>npx skills@latest add daveebbelaar/bama --skill=clone
- Install notes cover
- macOS
How do you install or deploy this agent?
Pick exactly one route per agent; installing two routes registers every skill twice.
Claude Code:
/plugin marketplace add daveebbelaar/bama
/plugin install bama@bamaCodex:
codex plugin marketplace add daveebbelaar/bama
codex plugin add bama@bamaOther agents such as Cursor, Gemini CLI and Copilot go through skills.sh; add --skill to install just one:
npx skills@latest add daveebbelaar/bama -a <agent>
npx skills@latest add daveebbelaar/bama --skill=cloneManual install:
git clone https://github.com/daveebbelaar/bama.git
bama/scripts/link-skills.shYou need macOS 26 or later and Xcode 26 for the Swift 6.2 toolchain. Cloning native apps also needs computer use, which requires a Claude Pro or Max plan.
How do you use this agent?
After installing, describe the target to your agent, or type /bama to let the router skill inspect your project and pick the next step.
Clone my to-do app as a native Mac app.
Screenshot every screen, write the user stories, and build milestone 1.If you have no idea yet, copy a plan from specs/ into an empty folder and point the agent at it:
Build the app in window-snapper.md with BAMA.The agent then works through the backlog one story per commit, snapshotting every page in light and dark mode and running the tests before each commit.
What are this agent's strengths and limitations?
- 21 skills are split into Start, Plan, Code, Design and Ship stages, so an agent can load only the one it needs
- The clone-to-milestone pipeline — screenshots, screen index, user stories, acceptance criteria, one story per commit — leaves an auditable trail
- build-and-verify and layout-grid fold light/dark snapshots and 4 pt alignment checks into the pre-commit loop
- specs/ ships 12 ready-made build plans for small Mac apps, so you can start without inventing a product first
- Ships as a Claude Code plugin, a Codex plugin and a skills.sh package, covering most mainstream coding agents
- Requires macOS 26 and Xcode 26; older systems are out
- Cloning native app screens depends on computer use and a Claude Pro or Max plan
- The software is free but you pay for the agent's model usage, which is not trivial
- The README warns that installing via two routes on one agent double-registers every skill
- The repo is mainly instructions and templates, so the quality of the built app still depends on the agent running them
How does this agent compare with similar options?
The README credits morluto's REA (Reverse Engineer Anything) as the origin of the reverse-engineering idea, Matt Pocock's skills repo for the skill format and writing rules, and names Paul Hudson's SwiftUI Pro and Antoine van der Lee's SwiftUI Expert as complementary SwiftUI skills. A sibling project, BAWA: Build Any Windows App, covers Windows.
Key facts side by side with the most closely related agents.
| Agent | Source review | Form / cost | Stars | Updated | Language | Full support on |
|---|---|---|---|---|---|---|
| BAMA: Build Any Mac App This agent | 61 · Some gaps | Agent plugin / skillFree + model costs | ★ 1.9k | 16d ago | Swift | Codex · Claude Code |
| Yardlet | 80 · Good | Desktop appFree | ★ 46 | today | Swift | Codex · Claude Code |
| Chops | 51 · Major gaps | Desktop appFree | ★ 2.1k | 2mo ago | Swift | — |
| Perch | 73 · Some gaps | Desktop appFree | ★ 31 | 5d ago | Swift | Codex · Claude Code |
How does FollowAgents rate this agent?
Why each dimension lost points
os-integrations explicitly prefers the no-permission API and asks for permissions at point of use with a one-line explanation; agent-cli makes destructive commands report-only until --yes. These support least privilege and user confirmation (2 each). performance warns that .trace files capture shell tokens and must never be committed or shared, showing sensitive-data awareness (2). Data-flow transparency is only an architecture sketch; socket access control and data destinations are unspecified (1). Dependency security relies on npx skills@latest and external skills.sh with no pinning or verification (1). Rollback is limited to keeping an old path for one milestone; no overall undo mechanism (1). Source attribution is explicit in README Credits (REA, Matt Pocock, etc.) (2).
AGENTS.md, README, and plugin.json agree on the skill list and writing rules, so the package is self-consistent (2). Dependency availability demands macOS 26+/Xcode 26/Swift 6.2 and computer use (Claude Pro/Max) for clone, with no fallback path (1). Failure messages are handled: agent-cli requires AgentError with fix hints and performance gives concrete diagnostic commands (2).
Targets Claude Code, Codex, Cursor, Gemini CLI and covers idea-to-ship scenarios (2). Capability boundaries are drawn via a CLI/MCP/App Intents comparison and 'optional' labels (2). Trigger precision is good: each SKILL.md description uses 'Use when' with per-branch triggers (2). Environment fit is narrow (macOS 26+) but clearly bounded, redirecting Windows users to BAWA (2).
Information architecture is organized by five pipeline stages, clear and coherent (3). Install notes give four routes with a warning against double-install (3). Naming stability has a plugin.json version and release process but couples skill names to directories with no deprecation policy (2). Examples exist (Quick start, specs) but there is no dedicated FAQ (2). Known limitations are only scattered (e.g., clone needs computer use), no consolidated section (1). MIT license is complete (3). Versioning has plugin.json version and release steps but no CHANGELOG (2). Maintenance responsibility points only to an individual author with no governance or contact detail (1).
Output usability is supported by checkable 'Done when' lines and concrete commands (2). Marginal value comes from structuring the macOS native workflow, though some content overlaps generic SwiftUI skills (2). Cost-benefit is reasonable given on-demand skill loading, but not quantified (2).
claim_traceability: README claims like '21 skills' and '12 specs' partly match plugin.json, but specs are not all visible in the packet, so claims cannot be fully checked (1). cross_source_corroboration: README, AGENTS.md, and plugin.json corroborate the skill list, but there is no test or run evidence (1). fact_inference_separation: docs are largely prescriptive assertions without separating verified fact from advice (1).
- Requires cutting-edge environment (macOS 26+/Xcode 26/Swift 6.2) and computer use (Claude Pro/Max) for clone, which many users cannot meet.
- Installs via npx skills@latest and external skills.sh with no version pinning or integrity verification, a supply-chain risk.
- agent-cli lets agents drive the running app over a private socket; socket access control and data flow are undocumented.
- Publisher identity is not verified by the FollowAgents enterprise registry; maintenance responsibility points only to an individual author.
- README claims of 21 skills and 12 specs are not all visible in the packet and cannot be fully verified.
Recent releases
Latest entries from the project's GitHub Releases. Notes are quoted from upstream as written, not rewritten or tested by FollowAgents.
-
bama--v1.1.1 BAMA 1.1.1
Release notes excerpt
What's Changed * Fix the app shell's grid guidance and check edges across areas by @daveebbelaar in https://github.com/daveebbelaar/bama/pull/16 * Release 1.1.1 by @daveebbelaar in https://github.com/daveebbelaar/bama/pull/17 Full Changelog: https://github.com/daveebbelaar/bama/compare/bama--v1.1.0...bama--v1.1.1View on GitHub ↗ -
bama--v1.1.0 BAMA 1.1.0
Release notes excerpt
What's Changed * Update the screenshots and launcher specs from Onyx by @daveebbelaar in https://github.com/daveebbelaar/bama/pull/3 * Keep new-app.sh going when the folder already has files by @daveebbelaar in https://github.com/daveebbelaar/bama/pull/5 * Find the app bundle when the agent CLI runs from PATH by @daveebbelaar in https://github.com/daveebbelaar/bama/pull/6 * Point Windows users to BAWA in the README by @daveebbelaar in https://github.com/daveebbelaar/bama/pull/9 …View on GitHub ↗
FAQ
Is BAMA a model or an app itself?
Why the macOS 26 and Xcode 26 requirement?
Does cloning an app reuse its source or assets?
Can I install both the plugin and the skills.sh package on one agent?
Does it work on Windows?
Is BAMA: Build Any Mac App free?
Is BAMA: Build Any Mac App open source?
Is BAMA: Build Any Mac App safe to use?
Is BAMA: Build Any Mac App still maintained?
Who makes BAMA: Build Any Mac App?
Thanks — we use this to improve the page.