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) — это набор навыков для агента, которые позволяют агенту для программирования исследовать, клонировать, спроектировать, собрать, оптимизировать и протестировать нативное приложение для macOS, написанное на Swift и SwiftUI, — от идеи до иконки в вашем Dock.
Это приложение, которое нужно установить, или набор инструментов для моего агента?Это набор навыков для агента (плагин для Claude Code / Codex), а не самостоятельное приложение; вы устанавливаете навыки в своего агента для программирования, и уже он пишет и собирает для вас приложение для Mac.
Как установить навыки?Для Claude Code и Codex есть свои способы установки; любой другой агент с поддержкой навыков (Cursor, Gemini CLI, Copilot) устанавливается через скрипт skills.sh, который может установить все навыки или только один с помощью флага --skill.
Что нужно иметь перед началом работы?Нужна macOS 26 или новее, Xcode 26+ для набора инструментов Swift 6.2 (сам графический интерфейс Xcode открывать не нужно) и агент с поддержкой навыков, например Claude Code, Codex, Cursor или Gemini CLI.
Есть ли подвох, прежде чем я начну клонировать приложение?Для работы навыка клонирования нативного приложения нужен computer use, а он доступен только с платным тарифом Claude Pro или Max; кроме того, если запустить установку сразу для двух разных агентов, каждый навык установится дважды.
Нужна ли самая свежая macOS или это работает и на старых Mac?Требуется macOS 26 или новее с установленным набором инструментов Xcode 26 / Swift 6.2; в README отдельно не указано, работает ли это на Mac с процессорами Intel или Apple Silicon.
Как навык клонирования на самом деле копирует внешний вид приложения?Он делает скриншоты каждого экрана целевого приложения с помощью computer use или браузера, составляет индекс экранов, а затем навык проектирования по приложению измеряет размеры, шрифты и цвета и сравнивает изображения пиксель за пикселем, пока пересборка не совпадёт с оригиналом.
Что делать, если я не хочу клонировать существующее приложение?В папке specs/ есть 12 готовых планов сборки небольших утилит для Mac (менеджер окон, лаунчер, история буфера обмена, запись экрана и другие) — скопируйте один из них в пустую папку и попросите агента его собрать.
Какие навыки для дизайна входят в набор?ux-design проектирует сценарии работы и доступность, mac-design применяет Liquid Glass и нативную разметку, design-system и design-kit создают нативный внешний вид на основе токенов, а app-icon генерирует иконку в стиле Liquid Glass в виде файла Icon Composer.
Откуда появилась идея BAMA?Проект ссылается на REA: Reverse Engineer Anything от morluto, где высказана мысль, что агент может провести обратный инжиниринг любого приложения, и переносит эту идею на создание нативных приложений для Mac.
Автор
daveebbelaar
Размер
1.2 MB
Звёзды
1.9K
Возраст
25 д
Коммиты · 90 дней