Shared from "Claude-Code" on Inkdown
The UI surface — REPL, Doctor, and ResumeConversation.
The screens/ directory contains exactly 3 screen components. Navigation is not router-based — screens are composed conditionally by parent components based on CLI flags, slash commands, and user actions.
REPL.tsx) — 5000+ linesThe central hub of the entire application. Handles the complete conversation lifecycle.
| State | Description |
|---|---|
'prompt' | Normal conversation view with input at bottom |
'transcript' | Read-only scrollable detailed view (like less pager), entered via Ctrl+O |
┌─────────────────────────────────────────────────────────────┐
│ REPL │
│ │
│ ┌─────────────────────────────────────────────────────────┐ │
│ │ FullscreenLayout │ │
│ │ │ │
│ │ ┌───────────────────────────────────────────────────┐ │ │
│ │ │ scrollable: │ │ │
│ │ │ Messages (conversation transcript) │ │ │
│ │ │ SpinnerWithVerb (loading indicator) │ │ │
│ │ │ Tool JSX (tool execution display) │ │ │
│ │ └───────────────────────────────────────────────────┘ │ │
│ │ │ │
│ │ ┌───────────────────────────────────────────────────┐ │ │
│ │ │ bottom: │ │ │
│ │ │ PromptInput (user input + autocomplete) │ │ │
│ │ │ CompanionSprite (buddy pet) │ │ │
│ │ │ PromptInputQueuedCommands │ │ │
│ │ └───────────────────────────────────────────────────┘ │ │
│ │ │ │
│ │ ┌───────────────────────────────────────────────────┐ │ │
│ │ │ modal (centered, stacked by focusedInputDialog): │ │ │
│ │ │ 'tool-permission' → PermissionRequest │ │ │
│ │ │ 'sandbox-permission' → SandboxPermissionRequest│ │ │
│ │ │ 'prompt' → PromptDialog │ │ │
│ │ │ 'elicitation' → ElicitationDialog │ │ │
│ │ │ 'cost' → CostThresholdDialog │ │ │
│ │ │ 'idle-return' → IdleReturnDialog │ │ │
│ │ │ 'worker-sandbox-permission' → SandboxPerm... │ │ │
│ │ └───────────────────────────────────────────────────┘ │ │
│ │ │ │
│ │ ┌───────────────────────────────────────────────────┐ │ │
│ │ │ overlay: permission requests │ │ │
│ │ └───────────────────────────────────────────────────┘ │ │
│ └─────────────────────────────────────────────────────────┘ │
│ │
│ Feature-gated panels: │
│ ├── TaskListV2 (expanded todos) │
│ ├── TungstenLiveMonitor (ant-only) │
│ ├── WebBrowserPanel (feature-gated) │
│ ├── CompanionFloatingBubble (buddy, fullscreen) │
│ ├── DevBar (ant-only debug) │
│ └── IssueFlagBanner │
└─────────────────────────────────────────────────────────────┘| Area | Details |
|---|---|
| User Input | Prompt submission, slash commands, autocomplete, vim mode |
| AI Responses | Streaming display, tool use rendering, thinking blocks |
| Permissions | Tool use dialogs, sandbox permissions, swarm worker permissions |
| Session Management | Cost tracking, session titles, background sessions |
| Multi-Agent | Teammate view, worker permissions, swarm communication |
| Remote Modes | --remote, --ssh, --connect |
| IDE Integration | VS Code/JetBrains connection, code selection |
| Bridge | Mobile/web remote control |
| Feedback | Surveys, frustration detection (ant-only) |
| Notifications | Rate limits, plugin status, settings errors, MCP connectivity |
Ctrl+O)When toggled to transcript mode:
┌────────────────────────────────────────────────────┐
│ Transcript Mode [Search: /] │
│ │
│ VirtualMessageList (virtualized scroll) │
│ ├── All messages with full detail │
│ ├── Tool inputs/outputs │
│ └── Timestamps, token counts │
│ │
│ TranscriptSearchBar (optional, triggered by /) │
│ ├── Incremental search │
│ ├── Match counting │
│ └── Index status (3/12) │
│ │
│ ───────────────────────────────────────────────── │
│ TranscriptModeFooter │
│ [Ctrl+O] Exit [g] Top [G] Bottom [/] Search │
└────────────────────────────────────────────────────┘| Category | Hooks |
|---|---|
| State | useAppState, useSetAppState, useAppStateStore |
| Remote | useRemoteSession, useDirectConnect, useSSHSession |
| Model | useMainLoopModel |
| MCP | useMergedClients, useMergedTools, useMergedCommands |
| Swarm | useSwarmInitialization, useInboxPoller |
| Bridge | useReplBridge |
| Queue | useQueueProcessor |
| Input | useTextInput, useVimInput, useTypeahead |
| IDE | useIDEIntegration, useIdeSelection, useIdeLogging |
| Voice | useVoiceIntegration |
| Cost | useCostSummary |
| Notifications | All 16 notification hooks |
| Surveys | useFeedbackSurvey, useMemorySurvey, usePostCompactSurvey |
| Plugins | useManagePlugins, usePluginRecommendationBase |
| Tasks | useTasksV2, useTaskListWatcher |
Doctor.tsx) — 575 linesDiagnostics screen showing installation health and configuration status.
| Section | Content |
|---|---|
| Installation | Type, version, package manager, binary path |
| Search | Ripgrep status |
| Updates | Auto-update settings, stable/latest dist tags |
| Sandbox | Sandbox configuration |
| MCP | Parsing warnings |
| Keybindings | Conflict warnings |
| Environment | Variable validation |
| Version Locks | PID-based locking |
| Agents | Definitions and parse errors |
| Plugins | Plugin errors |
| Context Usage | Unreachable permission rules, CLAUDE.md warnings, agent warnings, MCP warnings |
| Settings | Invalid settings |
Invoked via /doctor command. Dismissed with Enter/confirmation keybinding, which injects a system message back into the REPL.
ResumeConversation.tsx) — 399 linesSession picker that lets users browse and resume previous conversations.
┌───────────────────────────────────────────────┐
│ ResumeConversation │
│ │
│ [Loading] → Spinner + "Loading..." │
│ │
│ LogSelector (searchable, paginated list) │
│ ├── Session title │
│ ├── Last message preview │
│ ├── Timestamp │
│ └── PR number filter │
│ │
│ [On select] │
│ ├── Deserializes conversation from disk │
│ ├── Restores session state: │
│ │ ├── Costs │
│ │ ├── File history │
│ │ ├── Agent settings │
│ │ └── Worktree │
│ └── Renders <REPL> with restored messages │
│ │
│ [Cross-project] → Copy command + exit │
└───────────────────────────────────────────────┘agenticSessionSearch() for semantic session findingScreens are composed conditionally by parent components:
main.tsx / cli.tsx
│
├─ [Normal launch] → REPL
│
├─ [--resume flag] → ResumeConversation → REPL
│
├─ [/resume command] → ResumeConversation → REPL
│
├─ [/doctor command] → Doctor → (dismisses back to REPL)
│
└─ [Ctrl+O in REPL] → REPL (transcript mode)No router — just conditional rendering based on:
| File | Lines | Purpose |
|---|---|---|
src/screens/REPL.tsx | 5006 | Main conversation interface |
src/screens/Doctor.tsx | 575 | Diagnostics screen |
src/screens/ResumeConversation.tsx | 399 | Session picker |