{
 "schema_version": 1,
 "generated": "2026-11-09",
 "id": "daveebbelaar-bama--build-a-small-mac-utility-from-a-bama-spec",
 "repo": "daveebbelaar/bama",
 "repo_url": "https://github.com/daveebbelaar/bama",
 "repo_slug": "daveebbelaar-bama",
 "title": "Build a small Mac utility from one of BAMA's 12 specs",
 "page_title": "How to build a small Mac utility from one of BAMA's 12 specs with Bama",
 "summary": "Pick a ready build plan such as a window snapper and have your agent build it.",
 "who": "A developer who wants a first native Mac app but has no idea what to build.",
 "problem": "Starting a Mac app from a blank project is slow, and a vague idea leads nowhere.",
 "outcome": "A working small Mac app, such as a window snapper or clipboard history, built from a spec.",
 "steps": [
  "Install for Codex with `codex plugin marketplace add daveebbelaar/bama` and `codex plugin add bama@bama`",
  "Browse specs/ for the 12 build plans: window snapper, launcher, clipboard history and more",
  "Ask: Build the app in window-snapper.md with BAMA",
  "Let new-mac-app create the Swift package, build script and snapshot mode",
  "Use os-integrations for global hotkeys and menu bar, then build-and-verify"
 ],
 "agent_prompt": "Using daveebbelaar/bama, build the app in specs/<spec>.md. Start with new-mac-app, use os-integrations for hotkeys, and run build-and-verify before each milestone.",
 "agents": [
  "codex",
  "claude-code"
 ],
 "difficulty": "Intermediate",
 "time": "2 hours",
 "basis": "readme",
 "caveat": "This card is written from the daveebbelaar/bama README, not from a test run by Deduped. Before you start, make sure you have macOS 26 or later. Check the repo for newer instructions before you rely on these steps.",
 "category": "Software and DevOps",
 "tags": [
  "Software and DevOps"
 ],
 "lang": "swift",
 "requirements": [
  "macOS 26 or later",
  "Xcode 26 or later for the Swift 6.2 toolchain (you never open it)",
  "Claude Code, Codex, Cursor or Gemini CLI",
  "For clone on native apps: computer use (Claude Pro or Max)"
 ],
 "risk": "none",
 "seen_in_the_wild": false,
 "mentioned_publicly": false,
 "risks": [],
 "best": false,
 "score": 0.9,
 "evidence": [],
 "url": "https://dedupedai.com/use-cases/daveebbelaar-bama/build-a-small-mac-utility-from-a-bama-spec/",
 "md": "https://dedupedai.com/use-cases/daveebbelaar-bama/build-a-small-mac-utility-from-a-bama-spec/index.md",
 "disclaimer": "Deduped lists open-source repositories that belong to other people. We do not own, maintain, audit, or vouch for any of them, and a repo appearing here is not an endorsement or a safety check. The use cases, steps, and prompts are written by AI and may be incomplete, outdated, or just wrong. Where a use case is marked \"Seen in the wild\", we link to public posts where someone described something similar, but we have not verified those posts and the use case itself is still our AI's own write-up. Use all of this at your own risk. Only run code, commands, or agents on systems and accounts you are authorized to use, and read the code and every command before you run it, especially anything that touches credentials, files, or the network. Nothing here is professional, security, legal, or financial advice. All trademarks and project names belong to their respective owners, and their use here does not imply affiliation. Content is provided as is, without warranties of any kind. Found a mistake, a safety problem, or something you want removed? Email hello@dedupedai.com and we will look at it promptly.",
 "api": "https://dedupedai.com/api/v1/usecases/daveebbelaar-bama--build-a-small-mac-utility-from-a-bama-spec.json",
 "api_version": "v1"
}
