23. Top 20 Files to Study

If You Only Read 20 Files

#FileWhy it matters
1main.tsxStartup orchestration and product entry flow.
2commands.tsCommand control plane.
3Tool.tsTool platform contract.
4tools.tsCapability registry.
5tools/BashTool/BashTool.tsxShell execution runtime.
6tools/BashTool/bashSecurity.tsShell risk taxonomy.
7tools/BashTool/bashPermissions.tsShell permission engine.
8tools/FileReadTool/FileReadTool.tsModel-oriented file reading.
9tools/FileEditTool/FileEditTool.tsSafe in-place editing.
10services/api/client.tsProvider/auth adapter layer.
11services/api/claude.tsMain request engine.
12services/mcp/auth.tsMCP auth system.
13tools/AgentTool/AgentTool.tsxDelegation and multi-agent orchestration.
14interactiveHelpers.tsxInteractive shell lifecycle.
15components/TrustDialog/TrustDialog.tsxTrust boundary UX.
16history.tsSession history infrastructure.
17state/AppStateStore.tsWhole-product state map.
18services/compact/microCompact.tsSelective context shrinking.
19services/compact/autoCompact.tsAuto-compaction policy.
20services/SessionMemory/sessionMemory.tsBackground memory maintenance.

How To Use This List

Read these files in order if your goal is skill transfer, not full archive coverage. Together they give you the highest-value view of startup flow, tool contracts, safety, API integration, session management, and long-context handling.

Source Navigation

Recommended Source Files

  • source/main.tsx
  • source/tools/BashTool/BashTool.tsx
  • source/services/api/client.ts
  • source/services/api/claude.ts
  • source/tools/AgentTool/AgentTool.tsx

Next Files to Read

  • source/tools/FileReadTool/FileReadTool.ts
  • source/tools/FileEditTool/FileEditTool.ts
  • source/services/compact/compact.ts