A voice-first AI assistant that manages your calendar, email, and productivity. macOS menubar app (Swift) backed by a Go server on Fly.io.
| Layer | Technology |
|---|---|
| Client | Swift (macOS menubar app) — whisper.cpp STT, DeepInfra Kokoro TTS |
| Server | Go + gorilla/mux on Fly.io |
| Orchestration | Manager LLM (Gemini 3 Flash via OpenRouter) with 15 tools |
| Voice | Cerebras gpt-oss-120b (double-hop pattern) |
| Database | Supabase PostgreSQL (pgvector) + Redis (streams, ephemeral state) |
| Auth | Clerk (web) + Device sessions (macOS) |
# Check current state
make status
# Start full dev environment
make dev
# Run all tests
make test
# Deploy
make staging # → alfred-bicycle-api-staging
make prod # → alfred-bicycle-apicloud/ # Go backend (Fly.io)
├── manager/ # Manager LLM orchestration (15 tools)
├── subagents/ # Talker, Planner, Email, Productivity, Event Alerter, Task Intelligence
├── personalization/ # PersonaMem-v2 memory system (3-tier: HOT/WARM/COLD)
├── db/ # PostgreSQL client + schema
├── security/ # Auth middleware, rate limiting, encryption
├── routes_*.go # HTTP route handlers (69 endpoints)
└── main.go # Entry point + route registration
client-prod/ # Production macOS client (Swift)
client/ # Staging macOS client
client-dev/ # Dev macOS client (with wake word)
talker_prompts/ # LLM system prompts
docs/ # Documentation
Start here, go deeper as needed:
- ARCHITECTURE.md — Full system overview (10-min read). Single source of truth.
- docs/ — Documentation hub. Component guides for Manager, Client, Security, Streams, Memory, Observability.
- Package READMEs — Implementation details in
cloud/*/README.mdandclient-prod/README.md.
| Guide | What it covers |
|---|---|
| ARCHITECTURE.md | System architecture, LLM models, data flows, all components |
| docs/MANAGER_GUIDE.md | Manager orchestration brain — decision loop, 15 tools, system prompts |
| docs/CLIENT_GUIDE.md | Swift client — audio pipeline, wake word, VAD, TTS, SSE |
| docs/STREAMS_GUIDE.md | SSE protocol, Redis streams, whiteboard, action lifecycle |
| docs/SECURITY_GUIDE.md | Auth methods, middleware, OAuth encryption, rate limiting |
| docs/OBSERVABILITY_GUIDE.md | Logging, Supabase tracing, debugging checklist |
| docs/MEMORY_SYSTEM.md | PersonaMem-v2 — 3-tier memory, observers, consolidation |
| docs/API.md | All 69 HTTP endpoints |
| docs/SCHEMA.md | PostgreSQL tables + Redis key patterns |
| docs/DEPLOYMENT.md | Branch workflow, Fly.io deploys, rollback |
| CLAUDE.md | AI assistant instructions, debugging, production access |
Proprietary - All rights reserved.