macOS App

A native menu bar app for managing your Claude Code sessions and plans. It provides the same push, sync, and management features as the CLI, with auto-sync and a visual interface.

Install

1. Download the DMG
2. Open the DMG and drag RockstarNinja to your Applications folder
3. Launch from Applications — the app appears in your menu bar as a shuriken icon (no dock icon)

Requires macOS 14 (Sonoma) or later.

First launch

If you haven't used the CLI before, the app runs an onboarding flow:

1. Generates an Ed25519 keypair at ~/.rn/private.key and ~/.rn/public.key
2. Creates a default config at ~/.rn/config.toml
3. Registers your public key with the server

If you already have a CLI setup, the app uses your existing keys and config — no extra setup needed.

Features

Session browser

Sessions are grouped by project and sorted by date. Click a session to expand its preview, showing the first prompt and assistant response. Each session shows its turn count, file size, and git branch.

Plan browser

Plans are listed with their slug names, dates, and sizes. Click to expand a preview of the plan content.

Project browser

Projects are listed with their label, privacy level, and session/plan counts. Projects are automatically created when you push sessions — the project label is derived from your local project directory name. Click a project to expand its details.

Push and update

Push any session or plan with a single click. Unsynced items show a green push button; items that have changed locally since the last push show an update button instead.

• Push new sessions and plans to rockstar.ninja
• Update previously pushed items — creates a new version while keeping the same URL
• Set privacy level (public, secret, or private)
• Set a title and expiration

Stale items (synced but locally modified) are indicated with a yellow sync dot so you can see at a glance what needs updating.

Search and filter

Use the search bar to filter sessions and plans by name. The project picker lets you scope session results to a specific project.

Auto-sync

Toggle auto-sync from the sync status view. When enabled, the app watches ~/.claude/ for changes using FSEvents and automatically pushes new or modified sessions and plans in the background.

Notifications

The app sends macOS notifications when pushes complete, so you can work in Claude Code while the app syncs in the background.

Configuration

The app reads ~/.rn/config.toml — the same config file used by the CLI. Changes to the config are picked up automatically.

Key settings:

• server — the server URL (default: https://rockstar.ninja)
• [session] / [plan] — default privacy, expiration
• [[redact]] — client-side redaction rules applied before upload

See Configuration for the full reference.

CLI comparison