Releases: aka-kika/breakpoint
BreakPoint MD 1.2.0
BreakPoint MD is the markdown-file edition: every capture saves structured .md handoffs to your export folder (default ~/BreakPointMDSnapshots). It runs beside the full BreakPoint app (com.kika.BreakPointMD vs com.kika.BreakPoint).
Highlights
- Markdown file export only — no Apple Notes or Obsidian vault append in this edition
- Export content modes — Full handoff or Tasks only (Quick Wins, Todo, Next with Obsidian
- [ ]checkboxes) - Tasks-only respects capture mode — Extra pulls from Priority Stack / Resume Plan; Normal from Todo List; Code from Code Tasks; ADHD from its native sections
- Dual save in Tasks only mode — writes both
DoomsMoment_tasks_…mdand the fullDoomsMoment_…md - Output guardrails — strips model thinking blocks, normalizes priority bullets, reduces hallucinated example tasks
- ADHD prompt cleanup — no fake placeholder tasks; optional
## Nextsection; checkbox task format
Setup
- macOS 14.0+
- Recommended: Pieces OS for primary generation + MCP memory
- Optional: Ollama, OpenAI, Anthropic, or OpenRouter fallback
Branch: markdown-file-edition
BreakPoint 1.1.0
BreakPoint Release Notes
Version 1.1.0
BreakPoint is a macOS menu bar utility for capturing a Doom's Moment before stepping away from work. It gathers screen context, enriches it with Pieces long-term memory, generates a structured handoff, and exports to one or more destinations you choose.
Highlights
Settings refactor
- Capture tab — generation mode only (
Normal,ADHD,Code Mode,Extra) - Export tab — pick any combination of File, Notes, and Obsidian; export folder; Obsidian vault path; search tags
- Obsidian tab — Enable Obsidian mode toggle unlocks output templates (handoff, last-hour capture, end of day, morning briefing)
- AI tab — enable/disable AI generation; choose fallback provider
- Pieces tab — Pieces OS REST URL, Pieces MCP URL, connection tests
Obsidian mode (generation templates) and Obsidian export (vault append) are separate. You can use one without the other.
AI providers
- Toggle Enable AI Generation on or off
- Fallback providers: Ollama, OpenAI, Anthropic, OpenRouter
- Per-provider API keys, models, and connectivity test
- Pieces QGPT remains the primary path when available; AI providers are the structured fallback
Pieces MCP
- Configurable MCP URL (defaults to Cursor's Pieces server path)
- Ranked memory search during capture when Pieces is enabled
Obsidian export
- Append captures to
YYYY-MM-DD.mdin your vault or subfolder - Frontmatter, timestamped section headers, and template-aware generation when Obsidian mode is on
Menu bar polish
- Crisp programmatic menu bar bomb icon (template-friendly on light and dark menu bars)
- Last Capture submenu: Copy Text, Copy Path, Reveal
- Global hotkey:
Cmd + Shift + Escape
Setup Requirements
- macOS 14.0 or later
- Recommended: Pieces OS running (primary generation + MCP memory)
- Optional: Ollama, OpenAI, Anthropic, or OpenRouter for AI fallback
- Optional: Obsidian vault path when Obsidian is selected as an export destination
Notes For Users
- If Notes export is enabled, macOS may ask for Automation permissions.
- Screenshot OCR requires Screen Recording permission.
- Obsidian export needs a valid vault path and the Obsidian destination checked in Export.
- Large cloud models may take longer than small local Ollama models.
Migration From 1.0.0
- Old single export presets (
File,Notes,File + Notes) migrate to the new multi-select destinations automatically. - The former Save captures to Obsidian vault toggle becomes the Obsidian export destination.
- Output templates now require Enable Obsidian mode on the Obsidian tab.
Known Limitations
- Apple Notes export depends on local macOS automation permissions.
- Release builds may show AppIcon asset warnings in Xcode; the distributed DMG remains valid when signed and notarized.
Previous Release
See v1.0.0 for the initial public release notes.
BreakPoint 1.0.0
BreakPoint Release Notes
Version 1.0
BreakPoint is a notarized macOS menu bar utility for capturing a "Doom's Moment" before stepping away from work. It gathers current context, generates a structured handoff, and exports the result to Markdown files and optionally Apple Notes.
Highlights
- Four generation modes:
NormalADHDCode ModeExtra
- Configurable export presets:
FileNotesFile + Notes
- Configurable Pieces OS base URL in
Properties - Ollama model dropdown with refresh support
- Custom search tags field that is merged into generated hashtags
- Faster generation fallback behavior:
- Pieces QGPT fails fast if unavailable
- Ollama fallback uses a longer timeout for large prompts
- Ollama requests disable model "thinking" output to improve response speed
- Apple Notes export support with checklist formatting
- Global hotkey:
Cmd + Shift + Escape
Distribution Artifact
Attach the notarized DMG from:
build/notarization/BreakPoint.dmg
This DMG was:
- Developer ID signed
- notarized by Apple
- stapled successfully
Setup Requirements
- macOS 14.0 or later
- Ollama installed and running
- Pieces OS running on the configured base URL
Recommended Release Description
BreakPoint helps you preserve momentum before stepping away from your Mac. Trigger it from the menu bar or with Cmd + Shift + Escape, and it captures your current context into a structured Doom's Moment you can reopen later in Markdown or Apple Notes.
This release adds a cleaner settings experience with a configurable Pieces URL, an Ollama model picker, custom search tags for generated output, and faster generation fallback behavior.
Notes For Users
- If Apple Notes export is enabled, macOS may ask for Automation and Accessibility permissions.
- If screenshot OCR is needed, macOS may ask for Screen Recording permission.
- Large cloud-backed Ollama models may still take noticeably longer than small local models.
Known Limitations
- Apple Notes export depends on local macOS automation permissions.
- Current release builds still emit AppIcon asset warnings during Xcode build, but the notarized DMG is valid for distribution.