# arnavjainpro/ana architecture

> Architecture diagram of the GitHub repository arnavjainpro/ana, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/arnavjainpro/ana
- Repository: https://github.com/arnavjainpro/ana

## Overview

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: [`apps/backend/src/routes/completions.ts`](https://github.com/arnavjainpro/ana/blob/main/apps/backend/src/routes/completions.ts) (Turn endpoint), [`apps/desktop/src/renderer/App.tsx`](https://github.com/arnavjainpro/ana/blob/main/apps/desktop/src/renderer/App.tsx) (Workspace UI), [`apps/desktop/src/main/github/oauth.ts`](https://github.com/arnavjainpro/ana/blob/main/apps/desktop/src/main/github/oauth.ts) (GitHub sign-in), [`apps/backend/src/services/retrieval.ts`](https://github.com/arnavjainpro/ana/blob/main/apps/backend/src/services/retrieval.ts) (Context retrieval)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_desktop["Desktop experience"]
  node_renderer["Workspace UI<br/>[App.tsx]"]
  node_conversation_ui["Voice conversation"]
  node_panels["Mode panels"]
  node_conversation_state["Conversation state"]
  node_renderer_ipc["Renderer IPC<br/>[ipc.ts]"]
  node_preload["Safe IPC bridge<br/>[index.ts]"]
  node_main["Electron main<br/>[index.ts]"]
  node_oauth["GitHub sign-in<br/>[oauth.ts]"]
  node_backend_client["Backend client<br/>[backend.ts]"]
  node_token_store["Credential store<br/>[tokenStore.ts]"]
  node_ipc_handlers["IPC handlers"]
end

subgraph group_backend["Conversation backend"]
  node_auth_route["Auth endpoints<br/>[auth.ts]"]
  node_conversation_route["Conversation endpoint<br/>[conversation.ts]"]
  node_completion_route["Turn endpoint<br/>[completions.ts]"]
  node_turn["Turn orchestration<br/>[turn.ts]"]
  node_claude["AI reasoning<br/>[claude.ts]"]
  node_panel_bus["Panel dispatch<br/>[panelBus.ts]"]
  node_tavus["Voice sessions<br/>[tavus.ts]"]
end

subgraph group_repository["Repository services"]
  node_github_service["GitHub access<br/>[github.ts]"]
  node_repo_routes["Repository endpoints<br/>[repo.ts]"]
  node_indexer["Repository indexing<br/>[indexer.ts]"]
  node_embeddings["Text embeddings<br/>[embeddings.ts]"]
  node_retrieval["Context retrieval<br/>[retrieval.ts]"]
  node_database[("Vector database<br/>[client.ts]")]
  node_project_services["Project workflows<br/>[project.ts]"]
end

subgraph group_marketing["Public website"]
  node_web["Product website<br/>[App.tsx]"]
end

node_user(("User"))
node_github(("GitHub"))
node_anthropic(("Anthropic Claude"))
node_openai(("OpenAI embeddings"))
node_supabase[("Supabase")]
node_tavus_external(("Tavus CVI"))

node_user -->|"speaks and selects"| node_renderer
node_renderer -->|"hosts conversation"| node_conversation_ui
node_conversation_ui -.->|"updates turns"| node_conversation_state
node_renderer -->|"shows workspace"| node_panels
node_renderer -.->|"invokes API"| node_renderer_ipc
node_renderer_ipc -->|"uses bridge"| node_preload
node_preload -->|"dispatches IPC"| node_ipc_handlers
node_main -->|"registers handlers"| node_ipc_handlers
node_ipc_handlers -.->|"calls backend"| node_backend_client
node_oauth -->|"exchanges code"| node_backend_client
node_oauth -->|"saves token"| node_token_store
node_oauth -->|"opens authorization"| node_github
node_backend_client -->|"requests auth"| node_auth_route
node_auth_route -->|"exchanges code"| node_github_service
node_conversation_route -->|"processes turn"| node_turn
node_completion_route -->|"processes completion"| node_turn
node_completion_route -->|"retrieves context"| node_retrieval
node_completion_route -->|"requests reasoning"| node_claude
node_completion_route -->|"dispatches panel"| node_panel_bus
node_conversation_route -->|"creates sessions"| node_tavus
node_claude -->|"classifies and reasons"| node_anthropic
node_retrieval -->|"embeds query"| node_embeddings
node_embeddings -->|"requests vectors"| node_openai
node_retrieval -.->|"searches vectors"| node_database
node_indexer -.->|"embeds files"| node_embeddings
node_indexer -.->|"stores chunks"| node_database
node_database -->|"persists vectors"| node_supabase
node_repo_routes -.->|"accesses repositories"| node_github_service
node_github_service -->|"reads repository"| node_github
node_project_services -.->|"generates scaffold"| node_claude
node_tavus -->|"starts sessions"| node_tavus_external
node_web -.->|"presents product"| node_user

click node_renderer "https://github.com/arnavjainpro/ana/blob/main/apps/desktop/src/renderer/App.tsx"
click node_conversation_ui "https://github.com/arnavjainpro/ana/blob/main/apps/desktop/src/renderer/components/AnaConversation.tsx"
click node_panels "https://github.com/arnavjainpro/ana/tree/main/apps/desktop/src/renderer/panels"
click node_conversation_state "https://github.com/arnavjainpro/ana/blob/main/apps/desktop/src/renderer/store/conversationStore.ts"
click node_renderer_ipc "https://github.com/arnavjainpro/ana/blob/main/apps/desktop/src/renderer/lib/ipc.ts"
click node_preload "https://github.com/arnavjainpro/ana/blob/main/apps/desktop/src/preload/index.ts"
click node_main "https://github.com/arnavjainpro/ana/blob/main/apps/desktop/src/main/index.ts"
click node_oauth "https://github.com/arnavjainpro/ana/blob/main/apps/desktop/src/main/github/oauth.ts"
click node_backend_client "https://github.com/arnavjainpro/ana/blob/main/apps/desktop/src/main/lib/backend.ts"
click node_token_store "https://github.com/arnavjainpro/ana/blob/main/apps/desktop/src/main/lib/tokenStore.ts"
click node_ipc_handlers "https://github.com/arnavjainpro/ana/tree/main/apps/desktop/src/main/ipc"
click node_auth_route "https://github.com/arnavjainpro/ana/blob/main/apps/backend/src/routes/auth.ts"
click node_conversation_route "https://github.com/arnavjainpro/ana/blob/main/apps/backend/src/routes/conversation.ts"
click node_completion_route "https://github.com/arnavjainpro/ana/blob/main/apps/backend/src/routes/completions.ts"
click node_turn "https://github.com/arnavjainpro/ana/blob/main/apps/backend/src/services/turn.ts"
click node_claude "https://github.com/arnavjainpro/ana/blob/main/apps/backend/src/services/claude.ts"
click node_panel_bus "https://github.com/arnavjainpro/ana/blob/main/apps/backend/src/services/panelBus.ts"
click node_tavus "https://github.com/arnavjainpro/ana/blob/main/apps/backend/src/services/tavus.ts"
click node_github_service "https://github.com/arnavjainpro/ana/blob/main/apps/backend/src/services/github.ts"
click node_repo_routes "https://github.com/arnavjainpro/ana/blob/main/apps/backend/src/routes/repo.ts"
click node_indexer "https://github.com/arnavjainpro/ana/blob/main/apps/backend/src/services/indexer.ts"
click node_embeddings "https://github.com/arnavjainpro/ana/blob/main/apps/backend/src/services/embeddings.ts"
click node_retrieval "https://github.com/arnavjainpro/ana/blob/main/apps/backend/src/services/retrieval.ts"
click node_database "https://github.com/arnavjainpro/ana/blob/main/apps/backend/src/db/client.ts"
click node_project_services "https://github.com/arnavjainpro/ana/blob/main/apps/backend/src/routes/project.ts"
click node_web "https://github.com/arnavjainpro/ana/blob/main/apps/web/src/App.tsx"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_renderer,node_conversation_ui,node_panels,node_conversation_state,node_renderer_ipc,node_preload,node_main,node_oauth,node_backend_client,node_token_store,node_ipc_handlers,node_user toneBlue
class node_auth_route,node_conversation_route,node_completion_route,node_turn,node_claude,node_panel_bus,node_tavus,node_supabase toneAmber
class node_github_service,node_repo_routes,node_indexer,node_embeddings,node_retrieval,node_database,node_project_services toneMint
class node_web toneRose
class node_github,node_anthropic,node_openai,node_tavus_external toneIndigo
```

## Components

### Desktop experience

- [Workspace UI](https://github.com/arnavjainpro/ana/blob/main/apps/desktop/src/renderer/App.tsx): `apps/desktop/src/renderer/App.tsx`
- [Voice conversation](https://github.com/arnavjainpro/ana/blob/main/apps/desktop/src/renderer/components/AnaConversation.tsx): `apps/desktop/src/renderer/components/AnaConversation.tsx`
- [Mode panels](https://github.com/arnavjainpro/ana/tree/main/apps/desktop/src/renderer/panels): `apps/desktop/src/renderer/panels`
- [Conversation state](https://github.com/arnavjainpro/ana/blob/main/apps/desktop/src/renderer/store/conversationStore.ts): `apps/desktop/src/renderer/store/conversationStore.ts`
- [Renderer IPC](https://github.com/arnavjainpro/ana/blob/main/apps/desktop/src/renderer/lib/ipc.ts): `apps/desktop/src/renderer/lib/ipc.ts`
- [Safe IPC bridge](https://github.com/arnavjainpro/ana/blob/main/apps/desktop/src/preload/index.ts): `apps/desktop/src/preload/index.ts`
- [Electron main](https://github.com/arnavjainpro/ana/blob/main/apps/desktop/src/main/index.ts): `apps/desktop/src/main/index.ts`
- [GitHub sign-in](https://github.com/arnavjainpro/ana/blob/main/apps/desktop/src/main/github/oauth.ts): `apps/desktop/src/main/github/oauth.ts`
- [Backend client](https://github.com/arnavjainpro/ana/blob/main/apps/desktop/src/main/lib/backend.ts): `apps/desktop/src/main/lib/backend.ts`
- [Credential store](https://github.com/arnavjainpro/ana/blob/main/apps/desktop/src/main/lib/tokenStore.ts): `apps/desktop/src/main/lib/tokenStore.ts`
- [IPC handlers](https://github.com/arnavjainpro/ana/tree/main/apps/desktop/src/main/ipc): `apps/desktop/src/main/ipc`

### Conversation backend

- [Auth endpoints](https://github.com/arnavjainpro/ana/blob/main/apps/backend/src/routes/auth.ts): `apps/backend/src/routes/auth.ts`
- [Conversation endpoint](https://github.com/arnavjainpro/ana/blob/main/apps/backend/src/routes/conversation.ts): `apps/backend/src/routes/conversation.ts`
- [Turn endpoint](https://github.com/arnavjainpro/ana/blob/main/apps/backend/src/routes/completions.ts): `apps/backend/src/routes/completions.ts`
- [Turn orchestration](https://github.com/arnavjainpro/ana/blob/main/apps/backend/src/services/turn.ts): `apps/backend/src/services/turn.ts`
- [AI reasoning](https://github.com/arnavjainpro/ana/blob/main/apps/backend/src/services/claude.ts): `apps/backend/src/services/claude.ts`
- [Panel dispatch](https://github.com/arnavjainpro/ana/blob/main/apps/backend/src/services/panelBus.ts): `apps/backend/src/services/panelBus.ts`
- [Voice sessions](https://github.com/arnavjainpro/ana/blob/main/apps/backend/src/services/tavus.ts): `apps/backend/src/services/tavus.ts`

### Repository services

- [GitHub access](https://github.com/arnavjainpro/ana/blob/main/apps/backend/src/services/github.ts): `apps/backend/src/services/github.ts`
- [Repository endpoints](https://github.com/arnavjainpro/ana/blob/main/apps/backend/src/routes/repo.ts): `apps/backend/src/routes/repo.ts`
- [Repository indexing](https://github.com/arnavjainpro/ana/blob/main/apps/backend/src/services/indexer.ts): `apps/backend/src/services/indexer.ts`
- [Text embeddings](https://github.com/arnavjainpro/ana/blob/main/apps/backend/src/services/embeddings.ts): `apps/backend/src/services/embeddings.ts`
- [Context retrieval](https://github.com/arnavjainpro/ana/blob/main/apps/backend/src/services/retrieval.ts): `apps/backend/src/services/retrieval.ts`
- [Vector database](https://github.com/arnavjainpro/ana/blob/main/apps/backend/src/db/client.ts): `apps/backend/src/db/client.ts`
- [Project workflows](https://github.com/arnavjainpro/ana/blob/main/apps/backend/src/routes/project.ts): `apps/backend/src/routes/project.ts`

### Public website

- [Product website](https://github.com/arnavjainpro/ana/blob/main/apps/web/src/App.tsx): `apps/web/src/App.tsx`

### Other components

- **User**
- **GitHub**
- **Anthropic Claude**
- **OpenAI embeddings**
- **Supabase**
- **Tavus CVI**

## Connections

- User → Workspace UI: speaks and selects
- Workspace UI → Voice conversation: hosts conversation (evidence: `apps/desktop/src/renderer/App.tsx`)
- Voice conversation → Conversation state: updates turns
- Workspace UI → Mode panels: shows workspace (evidence: `apps/desktop/src/renderer/App.tsx`)
- Workspace UI → Renderer IPC: invokes API (evidence: `apps/desktop/src/renderer/App.tsx`)
- Renderer IPC → Safe IPC bridge: uses bridge (evidence: `apps/desktop/src/renderer/lib/ipc.ts`)
- Safe IPC bridge → IPC handlers: dispatches IPC (evidence: `apps/desktop/src/preload/index.ts`)
- Electron main → IPC handlers: registers handlers (evidence: `apps/desktop/src/main/index.ts`)
- IPC handlers → Backend client: calls backend (evidence: `apps/desktop/src/main/ipc/auth.ts`)
- GitHub sign-in → Backend client: exchanges code (evidence: `apps/desktop/src/main/github/oauth.ts`)
- GitHub sign-in → Credential store: saves token (evidence: `apps/desktop/src/main/github/oauth.ts`)
- GitHub sign-in → GitHub: opens authorization (evidence: `apps/desktop/src/main/github/oauth.ts`)
- Backend client → Auth endpoints: requests auth
- Auth endpoints → GitHub access: exchanges code (evidence: `apps/backend/src/routes/auth.ts`)
- Conversation endpoint → Turn orchestration: processes turn (evidence: `apps/backend/src/routes/conversation.ts`)
- Turn endpoint → Turn orchestration: processes completion (evidence: `apps/backend/src/routes/completions.ts`)
- Turn endpoint → Context retrieval: retrieves context (evidence: `apps/backend/src/routes/completions.ts`)
- Turn endpoint → AI reasoning: requests reasoning (evidence: `apps/backend/src/routes/completions.ts`)
- Turn endpoint → Panel dispatch: dispatches panel (evidence: `apps/backend/src/routes/completions.ts`)
- Conversation endpoint → Voice sessions: creates sessions (evidence: `apps/backend/src/routes/conversation.ts`)
- AI reasoning → Anthropic Claude: classifies and reasons
- Context retrieval → Text embeddings: embeds query (evidence: `apps/backend/src/services/retrieval.ts`)
- Text embeddings → OpenAI embeddings: requests vectors (evidence: `apps/backend/src/services/embeddings.ts`)
- Context retrieval → Vector database: searches vectors (evidence: `apps/backend/src/services/retrieval.ts`)
- Repository indexing → Text embeddings: embeds files
- Repository indexing → Vector database: stores chunks
- Vector database → Supabase: persists vectors (evidence: `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
