Skip to content

aka-kika/breakpoint

Repository files navigation

⏸️ BreakPoint

A panic button for your momentum. Save your work state and pick up exactly where you left off.

Download Releases Website


🌐 Get It Now

Website: https://akakika.com/breakpoint/
Download: Latest macOS .dmg


💡 The Problem

You're in the zone. Multiple tabs open. Code editor full of half-finished thoughts. Clipboard has that one thing you'll need later.

Then life happens — meeting, outage, interruption, brain fry.

You close your laptop. Hours later you open it again and... where were you?

Most apps save files. BreakPoint saves momentum.


✨ The Solution

Trigger BreakPoint from the menu bar or with Cmd + Shift + Escape. It captures context and turns it into a structured Doom's Moment — a clean handoff you can reopen in Markdown, Apple Notes, or Obsidian.

Coming back feels like a continuation, not a restart.


🎬 How It Works

  1. Trigger — menu bar click or global hotkey
  2. Capture — apps, windows, clipboard, screenshot OCR, local project context, Pieces memory
  3. Generate — Pieces QGPT first, then optional AI fallback (Ollama, OpenAI, Anthropic, OpenRouter)
  4. Export — send to any combination of File, Notes, and Obsidian

🚀 Features

Feature Description
⚡ One-action capture Menu bar or Cmd + Shift + Escape
🧠 Pieces + MCP memory Workstream context and ranked memory search
🤖 Multi-provider AI fallback Ollama, OpenAI, Anthropic, OpenRouter
📝 Four generation modes Normal, ADHD, Code Mode, Extra
📤 Multi-destination export File, Apple Notes, Obsidian vault
📓 Obsidian mode Optional output templates for vault-friendly markdown
🏷️ Search tags Custom hashtags merged into generated output
📋 Last Capture menu Copy text, copy path, reveal in Finder
🔒 Local-first Your data stays on your Mac

🛠️ Tech Stack

  • Swift + SwiftUI — native macOS menu bar app
  • Vision — screenshot OCR
  • Pieces OS — REST + MCP long-term memory
  • Ollama / OpenAI / Anthropic / OpenRouter — AI fallback providers
  • Apple Notes + Obsidian — optional export destinations

📥 Installation

  1. Download the latest .dmg
  2. Open it and drag BreakPoint to Applications
  3. Launch BreakPoint from Applications
  4. Grant Screen Recording and Automation permissions when prompted

⚙️ Settings Overview

Properties uses a fixed tabbed window:

Tab Purpose
Capture Generation mode
Obsidian Enable Obsidian mode + output template
Export Destinations, export folder, vault path, search tags
AI Enable AI generation + fallback provider
Pieces Pieces OS REST + MCP URLs

See HOWTO.md and FEATURES.md for details.


🛠️ Build From Source

git clone https://github.com/aka-kika/breakpoint.git
cd breakpoint

xcodebuild -project BreakPoint.xcodeproj -scheme BreakPoint \
  -destination 'platform=macOS' -derivedDataPath ./build build

open ./build/Build/Products/Debug/BreakPoint.app

Run tests and build from source in HOWTO.md.

Notarize a release DMG

./scripts/notarize-dmg.sh

Requires a stored notarytool keychain profile (defaults to autopilot-codex).


⌨️ Keyboard Shortcuts

Shortcut Action
Cmd + Shift + Escape Create Doom's Moment
Left-click menu bar icon Create Doom's Moment
Right-click menu bar icon Open menu

🔒 Privacy

  • Local-first capture and export
  • No telemetry or analytics built in
  • Screenshots and clipboard stay on your device
  • Cloud AI providers are only used when you configure them

📄 Docs


👨‍💻 Author

KIKA — Built for the moments when life interrupts flow.


📄 License

MIT — open source. See LICENSE.


Built with ❄️ by KIKA
Last Updated: June 4, 2026