How kaushikappani/ascend works
Ascend is a local-first desktop interview-training app. The learner onboards and builds a roadmap, opens generated lessons, answers adaptive questions, and receives grading and mastery updates; practice, company preparation, mock interviews, coach chat, and progress tracking are parallel product workflows. The React renderer reaches Electron main-process services through the preload/API boundary; those services use Claude Agent SDK capabilities and local persistence. The README documents several unsampled capabilities, so their subsystem nodes are retained, while uncertain internal call paths are omitted.
Main entry points: App.tsx App routing · lessons.ts Lesson service · runtime.ts Claude runtime · store.ts UI state and API
Components 31
Learner experience
- App routing
src/renderer/src/App.tsx - Roadmaps
src/renderer/src/features/learn - Lesson player
src/renderer/src/features/lesson/LessonPlayer.tsx - Practice
src/renderer/src/features/practice - Mock interviews
src/renderer/src/features/interview/InterviewPage.tsx - Company prep
src/renderer/src/features/targets - Coach chat
src/renderer/src/features/coach - Progress view
src/renderer/src/features/progress - Settings
src/renderer/src/features/settings - UI state and API
src/renderer/src/lib/store.ts - Onboarding
src/renderer/src/features/onboarding/Onboarding.tsx
Application services
- Lesson service
src/main/services/lessons.ts - Track service
src/main/services/tracks.ts - Target service
src/main/services/targets.ts - Interview service
src/main/services/interviews.ts - Chat service
src/main/services/chat.ts - Insights service
src/main/services/insights.ts - Background jobs
src/main/jobs.ts - Events and snapshots
src/main/events.ts
AI and learning engine
- Claude runtime
src/main/agent/runtime.ts - Agent prompts
src/main/agent/prompts.ts - Coach tools
src/main/agent/coachTools.ts - Answer grading
src/main/engine/grading.ts - Mastery and review
src/main/engine/mastery.ts - Lesson planning
src/main/engine/planner.ts - XP and rewards
src/main/engine/gamification.ts
Desktop and state
- Preload bridge
src/preload/index.ts - Main process
src/main/index.ts - IPC handlers
src/main/ipc.ts - Local learner data
src/main/store.ts
Other components
- Learner
Connections 42
- Learner → App routing: uses
src/renderer/src/App.tsx - App routing → Roadmaps: routes to
src/renderer/src/App.tsx - App routing → Practice: routes to
src/renderer/src/App.tsx - App routing → Mock interviews: routes to
src/renderer/src/App.tsx - App routing → Company prep: routes to
src/renderer/src/App.tsx - App routing → Coach chat: routes to
src/renderer/src/App.tsx - App routing → Progress view: routes to
src/renderer/src/App.tsx - App routing → Settings: routes to
src/renderer/src/App.tsx - App routing → Lesson player: opens lesson
src/renderer/src/App.tsx - App routing → Onboarding: shows first
src/renderer/src/App.tsx - Roadmaps → UI state and API: uses API state
src/renderer/src/features/learn/PathView.tsx - Lesson player → UI state and API: uses API state
src/renderer/src/features/lesson/LessonPlayer.tsx - Mock interviews → UI state and API: uses API state
src/renderer/src/features/interview/InterviewPage.tsx - Progress view → UI state and API: uses API state
src/renderer/src/features/progress/ProgressPage.tsx - UI state and API → Preload bridge: invokes bridge
- Preload bridge → IPC handlers: forwards RPC
- Main process → IPC handlers: registers handlers
src/main/index.ts - Main process → Lesson service: imports service
src/main/index.ts - Main process → Interview service: imports service
src/main/index.ts - Main process → Chat service: imports service
src/main/index.ts - Lesson service → Claude runtime: runs generation
src/main/services/lessons.ts - Lesson service → Agent prompts: builds primer prompt
src/main/services/lessons.ts - Lesson service → Answer grading: grades answers
src/main/services/lessons.ts - Lesson service → Mastery and review: updates mastery
src/main/services/lessons.ts - Lesson service → Lesson planning: plans questions
src/main/services/lessons.ts - Lesson service → XP and rewards: announces rewards
src/main/services/lessons.ts - Lesson service → Background jobs: starts jobs
src/main/services/lessons.ts - Lesson service → Events and snapshots: emits updates
src/main/services/lessons.ts - Lesson service → Local learner data: reads and writes
src/main/services/lessons.ts - Interview service → Claude runtime: runs sessions
src/main/services/interviews.ts - Interview service → Agent prompts: uses prompts
src/main/services/interviews.ts - Interview service → Local learner data: reads and writes
src/main/services/interviews.ts - Track service → Claude runtime: generates roadmaps
- Target service → Claude runtime: researches companies
- Chat service → Claude runtime: runs coach chat
- Claude runtime → Coach tools: registers MCP tools
- Claude runtime → Background jobs: reports activity
src/main/agent/runtime.ts - Claude runtime → Events and snapshots: streams events
src/main/agent/runtime.ts - Claude runtime → Local learner data: uses learner data
src/main/agent/runtime.ts - Local learner data → Events and snapshots: schedules snapshots
src/main/events.ts - Learner → Target service: sets prep target
- Learner → Insights service: views insights