Cursor Metro

1. What is it?

Cursor Metro is a lightweight, open-source macOS app that wraps the Claude Code CLI for fast, focused “vibe coding.”

The name Metro is a nod to small convenience stores or quick transit: you drop in, get the essentials, and move on—without full-screen Cursor windows and scattered terminals.

It is meant to stay on screen (or collapsed to a slim side panel) so you can track agent progress across projects without losing context in a maze of tabs.

2. Features

• Tasks and agents — Create tasks, delegate them to agents, and watch status in the sidebar until you are ready to review and complete them.
• Integrated terminal — Run builds and shell commands next to your tasks; the app can help wire this up if you are unsure how.
• Always-on, low-footprint UX — Designed for multiple projects and fewer distractions than juggling many Cursor windows and terminals.

3. Get started

Requirements: macOS 15 or later. To run agents, you need the Claude Code CLI installed and available on your PATH (commonly ~/.local/bin after install).

Pick one of the following:

Option 1 — Clone, Xcode, and build

1. Clone this repository.

2. Install Xcode from the Mac App Store (a full GUI macOS app build needs the Xcode app; Command Line Tools alone are not enough).

3. Compile — either open CursorMetro.xcodeproj in Xcode and use Product → Run (or Build), or from the repo root run:

   ./build.sh

   That produces a Debug build at build/Build/Products/Debug/Cursor Metro.app. For a Release build, use Product → Archive in Xcode, or run xcodebuild with -configuration Release and the same project/scheme.

Option 2 — Download release artifact and clear quarantine

1. Download the release (for example the .zip from GitHub Releases), unzip it, and move Cursor Metro.app where you want it (for example Applications).

2. First launch and permissions (Gatekeeper)
   Unsigned or non-notarized builds may be blocked the first time you open them.

   • Finder: Control-click (right-click) Cursor Metro.app → Open → confirm Open when macOS asks.

   • Terminal: Remove the quarantine flag, then open the app as usual:

     xattr -cr "/path/to/Cursor Metro.app"

     Replace /path/to/Cursor Metro.app with the real path (for example the copy in your Downloads folder or Applications).

3. If macOS still refuses to open the app, open System Settings → Privacy & Security, scroll to the message about Cursor Metro being blocked, and choose Open Anyway (you may need a failed open attempt first for this button to appear).