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.

Stars
★ 1.9k
Last updated
16d ago
License
MIT
Primary language
Swift

At a glance

How it runs
Agent plugin / skillCLI
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
macOS 26 or laterXcode 26 or later (Swift 6.2 toolchain)Node.js with npx (for skills.sh install)Claude Pro or Max (for computer-use based cloning of native apps)Shell / CLINetwork accessLocal filesystem
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.

  1. An indie developer likes a to-do or notes app and wants a native Mac version they own outright
  2. 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
  3. 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
  4. A product manager wants screenshots turned into a milestone backlog with acceptance criteria, then implemented story by story
  5. A team wants light and dark UI snapshots plus unit tests generated before every commit as a regression signal
  6. 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@bama

Codex:

codex plugin marketplace add daveebbelaar/bama
codex plugin add bama@bama

Other 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=clone

Manual install:

git clone https://github.com/daveebbelaar/bama.git
bama/scripts/link-skills.sh

You 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?

Pros
  • 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
Limitations
  • 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?

FollowAgents source review · FARS-2.1
Some gaps
61/ 100 5-point scale 3.1 / 5
Trust 16/29
Reliability 8/14
Adaptability 12/18
Convention 13/18
Effectiveness 9/13
Verifiability 3/8
Why each dimension lost points
Trust16 / 29 · 2.8/5

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).

Reliability8 / 14 · 2.9/5

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).

Adaptability12 / 18 · 3.3/5

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).

Convention13 / 18 · 3.6/5

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).

Effectiveness9 / 13 · 3.5/5

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).

Verifiability3 / 8 · 1.9/5

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).

Risks and how to mitigate them
  • 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.
Evidence confidence: Low Reviewed Nov 10, 2026 Reviewed revision 22dc792ea040
See the full review method →
Maintain this project? Add the FARS badge to your README

The badge shows the current review score and verdict and links back to this page. It refreshes about once an hour after a re-review.

FARS

[![FARS review](https://followagents.com/badge/bama.svg)](https://followagents.com/en/agents/bama)
<a href="https://followagents.com/en/agents/bama"><img src="https://followagents.com/badge/bama.svg" alt="FARS review"></a>

Recent releases

Latest entries from the project's GitHub Releases. Notes are quoted from upstream as written, not rewritten or tested by FollowAgents.

  1. 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.1
    View on GitHub ↗
  2. 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?
No. It is a collection of SKILL.md instructions and templates consumed by your coding agent — Claude Code, Codex, Cursor or Gemini CLI — which does the actual reasoning and code generation.
Why the macOS 26 and Xcode 26 requirement?
The skills target the Swift 6.2 toolchain and Liquid Glass design in macOS 26, and the build scripts rely on that toolchain, so older systems cannot satisfy them.
Does cloning an app reuse its source or assets?
The clone skill opens the app and screenshots every screen, producing a screen index used as reference; the implementation is rewritten from those screenshots rather than copied.
Can I install both the plugin and the skills.sh package on one agent?
The README advises against it: choose one route per agent, since two routes install every skill twice.
Does it work on Windows?
No. The README points Windows users to the separate BAWA: Build Any Windows App project.
Is BAMA: Build Any Mac App free?
The software is free, but BAMA: Build Any Mac App calls an AI model, and you pay that model provider for usage (or run a local model).
Is BAMA: Build Any Mac App open source?
Yes. The source code is on GitHub (daveebbelaar/bama) under the MIT licence.
Is BAMA: Build Any Mac App safe to use?
FollowAgents' FARS review (Nov 10, 2026) scored BAMA: Build Any Mac App 16/29 on trust and safety. None of the eight safety controls the review checks for was missing outright.
Is BAMA: Build Any Mac App still maintained?
Yes. The latest commit on GitHub is from 2026-11-05, within the last 30 days. The latest release is bama--v1.1.1 (2026-11-05).
Who makes BAMA: Build Any Mac App?
BAMA: Build Any Mac App is published on GitHub by the account daveebbelaar. FollowAgents has not verified which person or company is behind that account.
Was this page helpful?
View on GitHub ↗ Install ↓

Host ecosystems

Compare agents like this one

The same FARS review applied across the shortlist this agent qualifies for.

Related concepts