bama README

项目的 README,来自 github.com/daveebbelaar/bama。合并为一个 markdown 文件:README.md。

BAMA: Build Any Mac App

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.
Swift and SwiftUI. Local data. No Xcode GUI.

macOS 26+ Swift 6.2 21 skills Claude Code plugin Codex plugin MIT license

Quick start · How it works · Skills · Specs · Install

On Windows? Use BAWA: Build Any Windows App instead.

Quick start

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.

How it works

1. Clone

Your agent opens the app you like and screenshots every screen. It writes a screen index.

2. Plan

It turns the screens into user stories with checkable acceptance criteria, in milestones.

3. Build

It builds one story per commit. Before each commit it snapshots every page in light and dark mode and runs the tests.

Skills

StageSkillWhat it does
StartbamaRouter: finds where you are and calls the right skill
app-briefTurns an idea into a one-page brief
new-mac-appA working app from a template: Swift package, SwiftData, build script, snapshot mode, git
PlanresearchParallel researcher agents: market, users, features, design, macOS APIs
cloneScreenshots every screen of any app with computer use or a browser, writes a screen index
user-storiesA backlog with checkable acceptance criteria, in milestones
Codeswift-swiftuiSwift 6 concurrency, state, SwiftData, AppKit bridges, compiler errors
os-integrationsGlobal hotkeys, menu bar, floating panels, window control, screen capture, Shortcuts, URL schemes, CLI, permissions
performanceMeasure, then fix: main thread, GPU compositing, images, Instruments from the command line
improve-architectureFinds hot spots as the app grows and refactors one step per commit, with behavior proven unchanged
agent-cliOptional: a command line and MCP server, so Claude Code, Codex, and scripts can drive your app
Designux-designNames, flow, where each feature opens (inline, popover, sheet, window), words, and accessibility, before code
mac-designLiquid Glass, layout, toolbars, menus, keyboard, type, dark mode
design-systemNative look with an accent color people pick in Settings, then one set of tokens and one rules page
layout-gridA 4 pt grid with checks that fail on misalignment: a code lint, a layout probe in snapshot mode, and a grid overlay
design-kitYour own parts, not Apple's: three token layers, type, an icon set, every part in every state, custom window chrome, and a parts gallery
design-from-appRebuilds the look of an app you like from its screenshots: measures sizes, type, and colors, then compares pixel by pixel until it matches
app-iconA Liquid Glass icon written as an Icon Composer file, checked in every look
Shipbuild-and-verifyBuild, install, snapshot every page in light and dark, look at them
test-mac-appSwift Testing, an in-app self-test, a debug bridge an agent can drive
improve-loopWorks through the backlog one story per commit until a milestone is done

Specs

Not sure what to build? 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:

Build the app in window-snapper.md with BAMA.

Install

Pick one route per agent. Two routes install every skill twice.

Claude Code
/plugin marketplace add daveebbelaar/bama
/plugin install bama@bama

To get new versions, run this in your shell, then start a new session:

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.

Codex
codex plugin marketplace add daveebbelaar/bama
codex plugin add bama@bama
Any other agent (Cursor, Gemini CLI, Copilot, and more)

Uses skills.sh. Install all skills, or one with --skill.

npx skills@latest add daveebbelaar/bama -a <agent>
npx skills@latest add daveebbelaar/bama --skill=clone
By hand
git clone https://github.com/daveebbelaar/bama.git
bama/scripts/link-skills.sh       # links every skill into ~/.claude/skills and ~/.agents/skills

Requirements

Credits

License

MIT

bama (daveebbelaar/bama)

正在搜索数据库…

1.9K ·GitHub
这是什么?BAMA(Build Any Mac App)是一组智能体技能,能让编程智能体调研、克隆、设计、构建、优化并测试用 Swift 和 SwiftUI 编写的原生 macOS 应用,从一个想法一直做到它出现在你的程序坞(Dock)中。
这是我要安装的应用,还是给编程智能体用的工具包?它是一套智能体技能工具包(Claude Code / Codex 插件),本身不是应用;你把这些技能装进编程智能体里,之后由智能体为你编写并构建这款 Mac 应用。
我该如何安装这些技能?Claude Code 和 Codex 各有自己的安装途径;其他支持技能的智能体(Cursor、Gemini CLI、Copilot)可通过 skills.sh 脚本安装,该脚本既可以安装全部技能,也可以用 --skill 只安装其中一个。
使用前需要准备什么?你需要 macOS 26 或更高版本、用于提供 Swift 6.2 工具链的 Xcode 26+(实际上你从不需要打开 Xcode 的图形界面),以及支持技能的智能体,例如 Claude Code、Codex、Cursor 或 Gemini CLI。
在我开始克隆应用之前,有什么需要注意的地方吗?克隆技能用于原生应用时需要使用 computer use 功能,而该功能需要付费的 Claude Pro 或 Max 套餐;另外,同时为两个不同的智能体运行安装,会导致每个技能被安装两次。
这需要最新版的 macOS 吗?旧款 Mac 也能运行吗?需要 macOS 26 或更高版本,并已安装 Xcode 26 / Swift 6.2 工具链;README 没有专门说明 Intel 与 Apple Silicon 的区别。
克隆技能究竟是如何复刻应用外观的?它会使用 computer use 或浏览器,对目标应用的每一个界面截图,并编写一份界面索引;随后,由 design-from-app 技能测量尺寸、字体和颜色,并逐像素比对,直到重建的界面与原版一致。
如果我不想克隆现有应用,怎么办?specs/ 文件夹内附 12 份现成的构建方案,涵盖小型 Mac 实用工具(例如窗口吸附工具、启动器、剪贴板历史、屏幕录制工具等)。把其中一份复制到空文件夹里,然后告诉你的智能体去构建它即可。
它自带哪些设计类技能?ux-design 负责规划流程与无障碍功能,mac-design 应用 Liquid Glass 设计语言和原生布局,design-system 与 design-kit 用于构建基于设计令牌(token)的原生外观,app-icon 则可生成 Liquid Glass 风格的图标,并输出为 Icon Composer 文件。
BAMA 的创意来自哪里?项目鸣谢 morluto 开发的 REA: Reverse Engineer Anything,该项目提出智能体可以对任何应用进行逆向工程;BAMA 则把这一理念引入原生 Mac 应用的构建之中。
大小
1.2 MB
星标
1.9K
时长
25天
提交 · 90 天