Mobile-first companion UI for AI coding workflows
UI parity with OpenCode • Observability via Claude Code Hooks • Control via Claude Agent SDK
This repository is work in progress.
- ✅ Repo structure + documentation are being established.
- ⏳ Flutter app and bridge server implementation are not yet shipped.
If you're new here, start with: docs/README.md.
ReCursor is a Flutter mobile app designed to provide an OpenCode-like UI/UX on mobile (tool cards, diffs, session timeline), while integrating with a developer's desktop/local environment.
- UI/UX parity goal: ReCursor's mobile UI should feel like OpenCode desktop, adapted for touch and smaller screens.
- Claude Code integration goal: Observe and complement a user's Claude Code workflow from mobile.
Claude Code's Remote Control feature is first-party (designed for claude.ai/code and official Claude apps). ReCursor docs are written to avoid claiming access to any private/undocumented Remote Control protocol.
ReCursor's supported approach is:
- Claude Code Hooks: event observation (one-way)
- Claude Agent SDK: a parallel, controllable agent session that ReCursor can drive (approvals/tool execution live here)
C:/Repository/ReCursor/
├── apps/
│ └── mobile/ # Flutter app scaffold (no UI implementation yet)
├── packages/
│ └── bridge/ # Node/TypeScript bridge scaffold (no server logic yet)
├── docs/ # Source-of-truth project documentation
├── .github/ # CI/CD scaffolding
└── fastlane/ # Release automation scaffolding
- Docs index:
docs/README.md - Architecture overview:
docs/architecture/overview.md - Data flow diagrams:
docs/architecture/data-flow.md - Integrations:
- OpenCode UI patterns:
docs/integration/opencode-ui-patterns.md - Claude Code Hooks:
docs/integration/claude-code-hooks.md - Agent SDK:
docs/integration/agent-sdk.md
- OpenCode UI patterns:
See:
CONTRIBUTING.mdCODE_OF_CONDUCT.mdSECURITY.md
If you're using agentic AI to contribute, read AGENTS.md first.
MIT — see LICENSE.