# ReCursor Docs
> Mobile-first companion UI for AI coding workflows, documented as a bridge-first Astro Starlight site.

Canonical source documents live in `docs-site/src/content/docs/` in the repository.

## AI Artifacts
- [llms.txt](./llms.txt): Compact machine-readable navigation for the published documentation.
- [llms-full.txt](./llms-full.txt): Concatenated long-form documentation context for AI workflows.

## Architecture
System structure, data flow, and design constraints.

- [Bridge Protocol Specification](/ReCursor/architecture/bridge-protocol/): WebSocket message protocol between the ReCursor Flutter mobile app and the user-controlled TypeScript bridge server. Bridge-first, no-login: device pairing via QR code, no user accounts.
- [Data Flow Architecture](/ReCursor/architecture/data-flow/): Message flow between ReCursor mobile app, bridge server, and Claude Code via Hooks.
- [Data Models](/ReCursor/architecture/data-models/): Drift schemas, Hive models, and domain entities for ReCursor.
- [Project Structure](/ReCursor/architecture/project-structure/): Flutter directory layout and module organization for ReCursor.
- [Architecture Overview](/ReCursor/architecture/system-overview/): System architecture for ReCursor: a Flutter mobile app with OpenCode-like UI. Bridge-first, no-login: connects to your user-controlled desktop bridge via secure tunnel.

## Integrations
Supported Claude Code and OpenCode integration paths.

- [Agent SDK Integration](/ReCursor/integrations/agent-sdk/): Using the Claude Agent SDK for parallel agent sessions in ReCursor. This is a supported integration path — ReCursor does not claim to mirror or control existing Claude Code sessions via unsupported Remote Control protocols.
- [Claude Code Hooks Integration](/ReCursor/integrations/claude-code-hooks/): Configure Claude Code Hooks to POST events to the ReCursor bridge server for mobile consumption. This is a supported integration path for one-way event observation — not a Remote Control protocol.
- [OpenCode UI Patterns for ReCursor](/ReCursor/integrations/opencode-ui-patterns/): Mapping OpenCode's terminal-native UI components to Flutter mobile widgets.

## Operations
Security, notifications, CI/CD, and testing guidance.

- [CI/CD Pipeline](/ReCursor/operations/ci-cd/): GitHub Actions + Fastlane for building, testing, and distributing ReCursor to iOS and Android.
- [Offline-First Architecture](/ReCursor/operations/offline-architecture/): How the ReCursor app works without connectivity and syncs when reconnected.
- [In-App Notification Architecture](/ReCursor/operations/push-notifications/): How the ReCursor bridge server notifies the mobile app about agent events — no Firebase, fully WebSocket-based.
- [Security Architecture](/ReCursor/operations/security-architecture/): Best practices for securing the WebSocket bridge between the ReCursor mobile app and the coding agent.
- [Testing Strategy](/ReCursor/operations/testing-strategy/): Comprehensive testing approach for ReCursor, a Flutter app with WebSocket connections and Claude Code integrations.

## Reference
Protocol, API, error handling, and type contract references.

- [Bridge HTTP API Specification](/ReCursor/reference/bridge-http-api/): REST endpoint specification for the ReCursor bridge server. Complements the WebSocket protocol with HTTP endpoints for hook ingestion, health checks, and control operations.
- [Error Handling & Recovery Specification](/ReCursor/reference/error-handling/): Error taxonomy, session recovery patterns, and reconnection strategies for the ReCursor bridge protocol. Grounded in benchmark research from remote-claude, BAREclaw, and code-server patterns.
- [Dart ↔ TypeScript Type Mapping Specification](/ReCursor/reference/type-mapping/): Cross-language contract defining type-safe serialization between Flutter (Dart) and Bridge (TypeScript). TypeScript protocol is source-of-truth.

## Legal
Policy and terms documents for the project.

- [Privacy Policy](/ReCursor/legal/privacy-policy/): **Last updated: 2026-03-17**
- [Terms of Service](/ReCursor/legal/terms-of-service/): **Last updated: 2026-03-17**