Flowback Documentation
Technical reference, integration guides, and operational manuals for developers and contributors.
🚀 Getting Started
Quick Start Guide →
Get up and running with Flowback in under 3 minutes. Test intent detection and focus restoration.
Installation & Setup →
Step-by-step DMG installation, Homebrew, Gatekeeper verification, and uninstallation instructions.
CLI Reference →
Complete syntax and options for flowback doctor, status, focus-lock, and emit.
🤖 Integrations & Adapters
Agent Integrations →
Hook and background detection for Google Antigravity, Claude Code, GitHub Copilot, Codex, Windsurf, OpenCode, and Cursor.
Application Adapters →
Window discovery adapters for VS Code variants, Cursor, Windsurf, terminals, and browsers.
JSON Event Protocol (v1) →
Complete schema specification for emitting custom agent events over Unix domain socket IPC.
⚙️ Configuration & Policies
Configuration & Policies →
Multi-tier policy hierarchy (Workspace > Application > Provider > Global) in config.json.
Focus Engine & Arbitration →
Intent sensing, priority ordering, cooldown windows, and macOS Spaces policies.
Troubleshooting Guide →
Step-by-step diagnostic fixes for Accessibility permissions, notifications, and socket errors.
🏗️ Architecture & Engineering
Architecture Specification →
Deep technical architecture, subsystem boundaries, concurrency model, and decoupling principles.
Development Guide →
Compiling from source, running the 1,040-assertion test suite across 36 suites, and contributing.
Release Engineering →
Release checklists, code signing, Apple notarization, checksum verification, and rollback processes.