bama

daveebbelaarMIT活跃维护

一套给 AI 编码代理用的技能包,让 Claude Code、Codex 等代理能调研、克隆、设计、构建、优化并测试原生 macOS 应用,用 Swift 和 SwiftUI 直接出成品。

BAMA: Build Any Mac App. Agent skills to research, clone, design, build, optimize, and test native macOS apps with Swift and SwiftUI.

bama--v1.1.1发布于 2026-11-05 10:08 UTC1,742star +74 / 7 天215fork同步于 2026-11-10 17:49 UTC

怎么上手

由 README 提炼,执行前请确认
npx skills@latest add daveebbelaar/bama
硬件要求按 README 说明

需要 macOS 26 或更高版本,以及 Xcode 26 或更高版本(提供 Swift 6.2 工具链,但无需打开 Xcode 图形界面)。README 未说明 CPU/GPU 或显存要求。

下载:源码 zip·GitHub Releases(安装包)本站不镜像安装包

项目说明

由 README 自动翻译提炼

一套让 AI 代理用 Swift 和 SwiftUI 从零构建原生 Mac 应用的技能集

一套给 AI 编码代理用的技能包,让 Claude Code、Codex 等代理能调研、克隆、设计、构建、优化并测试原生 macOS 应用,用 Swift 和 SwiftUI 直接出成品。

核心能力

  • 用 clone 技能截图目标应用并生成界面索引
  • 把界面拆成带验收标准的用户故事与里程碑
  • 每个提交只实现一个故事并跑测试与明暗模式快照
  • 覆盖 Swift 6 并发、SwiftData、AppKit 桥接等编码技能
  • 内置 Liquid Glass 设计规范与 4pt 网格对齐检查

容易踩的坑

每个代理只选一种安装方式,两种方式同时用会把技能装两遍;clone 原生应用需要 computer use 能力(Claude Pro 或 Max);需 macOS 26 与 Xcode 26 以上,低版本无法使用。

内容由模型根据 README 生成,可能不完整或不准确,以官方文档为准。看原文 README

最近发版

2 个版本bama--v1.1.1
  1. bama--v1.1.1BAMA 1.1.1最新正式版2026-11-05 · 2026-11-05 10:08 UTC

    What's Changed

    Full Changelog: https://github.com/daveebbelaar/bama/compare/bama--v1.1.0...bama--v1.1.1

  2. bama--v1.1.0BAMA 1.1.02026-11-05 · 2026-11-05 09:56 UTC
    查看更新说明

    What's Changed

    New Contributors

    Full Changelog: https://github.com/daveebbelaar/bama/commits/bama--v1.1.0

用户点评

登录用户的真实使用记录,可按版本和硬件筛选
共 0 条

    还没有人点评。第一个说出真实体验的人最有价值。

    README 原文

    未翻译

    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

    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.

    /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 plugin marketplace add daveebbelaar/bama
    codex plugin add bama@bama
    

    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
    
    git clone https://github.com/daveebbelaar/bama.git
    bama/scripts/link-skills.sh       # links every skill into ~/.claude/skills and ~/.agents/skills
    

    Requirements

    • macOS 26 or later
    • Xcode 26 or later, for the Swift 6.2 toolchain (you never open it)
    • An agent that supports skills: Claude Code, Codex, Cursor, Gemini CLI
    • For clone on native apps: computer use (Claude Pro or Max)

    Credits

    • The idea and the "any" promise come from REA: Reverse Engineer Anything by morluto. REA showed that an agent can reverse engineer any app. BAMA takes that idea to the Mac.
    • Skill format and writing rules follow Matt Pocock's skills and his writing-for-agents skill.
    • Works well with SwiftUI Pro by Paul Hudson and SwiftUI Expert by Antoine van der Lee.

    License

    MIT