Repolode
Submit
daveebbelaar

daveebbelaar/bama

Agent skills that guide a coding agent through researching, cloning, designing, building and testing a native macOS app in Swift and SwiftUI.

View on GitHub
Stars
1,661
Forks
204
Open issues
0
Last commit
2 days ago

What is it?

BAMA is a set of agent skills for building native macOS apps. You point an agent at an app you like, and it screenshots each screen, writes a screen index, turns the screens into user stories with checkable acceptance criteria, and then builds them one story per commit. Before each commit, the build snapshots every page in light and dark mode and runs the tests.

The skills cover the full path: a project template with Swift package, SwiftData, build script and snapshot mode, plus skills for Swift 6 concurrency, macOS integrations such as global hotkeys, menu bar items and floating panels, performance measurement, Liquid Glass design, and icon creation. The project runs as a plugin for Claude Code and Codex, or through skills.sh for other agents. It requires macOS 26 or later and Xcode 26 for the Swift 6.2 toolchain, though the README notes the user never needs to open Xcode's GUI.

The repository also includes 12 build plans in a specs folder for small Mac apps such as a window snapper, window switcher, launcher and clipboard history, which can be handed to an agent as a starting point.

Key features

  • 01Clones an existing app by screenshotting every screen and writing a screen index.
  • 02Breaks ideas into milestone-based user stories with checkable acceptance criteria.
  • 03Builds one story per commit, with light and dark mode snapshots and tests before each commit.
  • 04Provides skills for SwiftUI state, SwiftData, AppKit bridges and macOS system integrations.
  • 05Installs as a Claude Code or Codex plugin, or via skills.sh for other agents.

Use cases

  • Rebuilding a familiar Mac app as your own native version with an agent doing most of the work.
  • Starting a small menu bar or utility app from a ready-made Swift and SwiftUI template.
  • Following one of the included build plans to create a small window management or clipboard tool.
  • Letting a coding agent write, test and snapshot a macOS app with less manual setup.

Quick start

  1. 1

    Install the skills with the skills.sh command

    npx skills@latest add daveebbelaar/bama
  2. 2

    Ask your agent to clone an app and build the first milestone

Things to know

  • Requires macOS 26 or later and Xcode 26 or later, since it targets Swift 6.2 for Mac apps.
  • Cloning native apps with computer use requires a Claude Pro or Max subscription.
  • It only works with agents that support skills, such as Claude Code, Codex, Cursor, or Gemini CLI.

In collections

Skill packs for Claude Code and CodexClaude Code tools, skills & pluginsOpen-source AI agent frameworks & appsAI agent skill librariesOpen-source Mac apps

Topics

#agent-skills#ai-agents#swift#swiftui#macos#native-apps#claude-code#swiftdata#app-clone#claude-code-plugin

FAQ

What is bama?
Agent skills that guide a coding agent through researching, cloning, designing, building and testing a native macOS app in Swift and SwiftUI. BAMA is a set of agent skills for building native macOS apps. You point an agent at an app you like, and it screenshots each screen, writes a screen index, turns the screens into user stories with checkable acceptance criteria, and then builds them one story per commit. Before each commit, the build snapshots every page in light and dark mode and runs the tests.
Is bama free to use? What license does it have?
bama is open source under the MIT license. Check the license terms before using it in commercial products.
Is bama still maintained?
Actively maintained. The last commit to bama was on Nov 5, 2026.
What can I use bama for?
Rebuilding a familiar Mac app as your own native version with an agent doing most of the work. Starting a small menu bar or utility app from a ready-made Swift and SwiftUI template. Following one of the included build plans to create a small window management or clipboard tool. Letting a coding agent write, test and snapshot a macOS app with less manual setup.
How do I install bama?
Install the skills with the skills.sh command: npx skills@latest add daveebbelaar/bama Ask your agent to clone an app and build the first milestone
Where can I get bama?
The source code and installation instructions are on GitHub: https://github.com/daveebbelaar/bama

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects