ClaireEverything, filterable
All documentation
47 documents across seven sections. Filter by purpose or lifecycle, or press ⌘K to search the full text of every page.
47 of 47 documents
Get started
Set up a local Claire workspace and explore the product safely.
Repository setupClone Claire and start mock mode without any third-party accounts.Environment setupConfigure local, device, and production environments for Claire.Mock bridge modeRun Claire without real messaging accounts for safe local development and tests.Desktop companion setupSet up the Claire Desktop companion for connection flows that require a computer.
Build Claire
Architecture, clients, testing, and shared interface work.
Architecture overviewHow Claire connects mobile, desktop, the API, Matrix, and plugins.Mobile developmentWork on the Expo iOS, Android, and mobile web client.Desktop developmentWork on the Electron desktop app.Design system migration guideMove Claire surfaces onto shared semantic tokens and native primitives, incrementally.TestingUnit, plugin fixture, lint, typecheck, and Storybook checks.E2E test selector mapStable test identifiers for Claire’s browser and mobile acceptance flows.Desktop implementation specificationArchitecture and delivery plan for Claire Desktop and its native companion bridge.Loops: relevance and evaluationHow relevance scoring decides whether a group message concerns the user, and how to evaluate it.
Deploy & operate
Self-hosting, infrastructure, environment, and production references.
Self-hostingRun Claire on your own infrastructure without publishing operator secrets.Production setupPublic checklist for deploying Claire without exposing live infrastructure details.Deploying Claire to RailwayA worked example of deploying the Claire API and its dependencies to a managed host.Environment variablesPublic reference for Claire’s environment variables. No live values.Matrix bridge referenceReference for Claire’s Synapse and mautrix bridge integration.Platform modeProduction configuration for direct and Matrix-backed platform adapters.Deploying the databaseSafely apply Claire schema changes and reload the API schema cache.Database schema verificationDetect schema drift and verify production database migrations.Google OAuth setupConfigure Google sign-in for Claire without committing provider credentials.
Product & roadmap
Capabilities, roadmap, product specifications, and public security boundaries.
Product roadmapWhat is available, what is being worked on, what is planned, and what is still research.Connector and hosting roadmapDelivery waves, connection models, and verification gates for Claire’s network catalog.How Loops workA loop is one thing you still owe someone, or that someone still owes you — and how Claire decides which ones are yours.Security claims and validation roadmapPublic security boundaries, and the evidence required before stronger claims are made.AI platform and self-hosting specificationProduct architecture for managed AI, bring-your-own keys, local models, and self-hosting.AI model selection and cost modelProvider-neutral model roles, prompt-cache economics, and the measured cost model for Claire loops.End-to-end encryption researchA research boundary for future client-held encryption; not a current Claire feature or product claim.Payments and AI credits specificationSubscription, credit, billing, entitlement, and provider-key design for Claire AI.Ask Claire v2: streaming, retrieval, and cost specificationA staged implementation specification for a faster, cheaper, provider-portable Ask Claire with grounded streaming answers and a safe path to plugin actions.Claire on-device intelligence specificationA local-first architecture for on-device models, private message search, Ask Claire, Loop detection, and safe action proposals.Notification reliabilityPublic delivery notes for reliable mobile and macOS notifications.
Extensibility
Build and operate Claire plugins.
Plans
Active implementation plans and historical delivery records.
Close your loops campaignPreview and edit the interactive campaign concept for Claire’s Loops tab.Loops revamp planImplementation plan for thread-of-intent detection, loop details, plugins, evaluation, and provider-neutral AI.Conversation settings and smart cards planDesign and implementation plan for conversation settings, profiles, and AI smart cards.Per-conversation notification controlsProduct and technical specification for turning Claire notifications on or off for one conversation at a time.Railway deployment planImplementation plan for deploying Claire and its supporting services to Railway.Rich conversation capabilitiesImplementation plan for replies, attachments, voice notes, media playback, message actions, and desktop parity in Claire conversations.Unified AI messenger client planClient architecture and implementation plan for the unified messaging experience.Conversation detail screen planImplementation record for opening a conversation from the unified inbox.Matrix bridge integration planOriginal implementation plan for routing Claire messaging platforms through Matrix bridges.Open-source launch handoff promptArchived handoff instructions for the Claire open-source launch.Open-source launch planArchived plan for the monorepo cleanup, website, and initial developer documentation.
Contribute
How the project is built, reviewed, and improved in public.