How arnavjainpro/ana works
Ana is an Electron voice-first coding partner: users connect a GitHub repository, speak a request, and receive an explanation or plan in the workspace; build, debug, review, and new-project workflows are also described. The desktop renderer uses IPC to reach the main process and backend. Backend routes orchestrate conversation turns, repository context, AI services, and panel responses; indexing and persistence support repository understanding. The README documents several integrations and modes whose implementation was not sampled, so those links are documented rather than source-verified.
Main entry points: completions.ts Turn endpoint · App.tsx Workspace UI · oauth.ts GitHub sign-in · retrieval.ts Context retrieval
Components 32
Desktop experience
- Workspace UI
apps/desktop/src/renderer/App.tsx - Voice conversation
apps/desktop/src/renderer/components/AnaConversation.tsx - Mode panels
apps/desktop/src/renderer/panels - Conversation state
apps/desktop/src/renderer/store/conversationStore.ts - Renderer IPC
apps/desktop/src/renderer/lib/ipc.ts - Safe IPC bridge
apps/desktop/src/preload/index.ts - Electron main
apps/desktop/src/main/index.ts - GitHub sign-in
apps/desktop/src/main/github/oauth.ts - Backend client
apps/desktop/src/main/lib/backend.ts - Credential store
apps/desktop/src/main/lib/tokenStore.ts - IPC handlers
apps/desktop/src/main/ipc
Conversation backend
- Auth endpoints
apps/backend/src/routes/auth.ts - Conversation endpoint
apps/backend/src/routes/conversation.ts - Turn endpoint
apps/backend/src/routes/completions.ts - Turn orchestration
apps/backend/src/services/turn.ts - AI reasoning
apps/backend/src/services/claude.ts - Panel dispatch
apps/backend/src/services/panelBus.ts - Voice sessions
apps/backend/src/services/tavus.ts
Repository services
- GitHub access
apps/backend/src/services/github.ts - Repository endpoints
apps/backend/src/routes/repo.ts - Repository indexing
apps/backend/src/services/indexer.ts - Text embeddings
apps/backend/src/services/embeddings.ts - Context retrieval
apps/backend/src/services/retrieval.ts - Vector database
apps/backend/src/db/client.ts - Project workflows
apps/backend/src/routes/project.ts
Public website
- Product website
apps/web/src/App.tsx
Other components
- User
- GitHub
- Anthropic Claude
- OpenAI embeddings
- Supabase
- Tavus CVI
Connections 32
- User → Workspace UI: speaks and selects
- Workspace UI → Voice conversation: hosts conversation
apps/desktop/src/renderer/App.tsx - Voice conversation → Conversation state: updates turns
- Workspace UI → Mode panels: shows workspace
apps/desktop/src/renderer/App.tsx - Workspace UI → Renderer IPC: invokes API
apps/desktop/src/renderer/App.tsx - Renderer IPC → Safe IPC bridge: uses bridge
apps/desktop/src/renderer/lib/ipc.ts - Safe IPC bridge → IPC handlers: dispatches IPC
apps/desktop/src/preload/index.ts - Electron main → IPC handlers: registers handlers
apps/desktop/src/main/index.ts - IPC handlers → Backend client: calls backend
apps/desktop/src/main/ipc/auth.ts - GitHub sign-in → Backend client: exchanges code
apps/desktop/src/main/github/oauth.ts - GitHub sign-in → Credential store: saves token
apps/desktop/src/main/github/oauth.ts - GitHub sign-in → GitHub: opens authorization
apps/desktop/src/main/github/oauth.ts - Backend client → Auth endpoints: requests auth
- Auth endpoints → GitHub access: exchanges code
apps/backend/src/routes/auth.ts - Conversation endpoint → Turn orchestration: processes turn
apps/backend/src/routes/conversation.ts - Turn endpoint → Turn orchestration: processes completion
apps/backend/src/routes/completions.ts - Turn endpoint → Context retrieval: retrieves context
apps/backend/src/routes/completions.ts - Turn endpoint → AI reasoning: requests reasoning
apps/backend/src/routes/completions.ts - Turn endpoint → Panel dispatch: dispatches panel
apps/backend/src/routes/completions.ts - Conversation endpoint → Voice sessions: creates sessions
apps/backend/src/routes/conversation.ts - AI reasoning → Anthropic Claude: classifies and reasons
- Context retrieval → Text embeddings: embeds query
apps/backend/src/services/retrieval.ts - Text embeddings → OpenAI embeddings: requests vectors
apps/backend/src/services/embeddings.ts - Context retrieval → Vector database: searches vectors
apps/backend/src/services/retrieval.ts - Repository indexing → Text embeddings: embeds files
- Repository indexing → Vector database: stores chunks
- Vector database → Supabase: persists vectors
apps/backend/src/db/client.ts - Repository endpoints → GitHub access: accesses repositories
- GitHub access → GitHub: reads repository
- Project workflows → AI reasoning: generates scaffold
- Voice sessions → Tavus CVI: starts sessions
- Product website → User: presents product