Shared from "Claude-Code" on Inkdown
entrypoints/cli.tsx, main.tsx, entrypoints/init.ts, setup.ts.
Responsibility: process boot, trust-sensitive initialization, and branch selection between interactive, headless, and bridge modes.bootstrap/state.tsstate/AppStateStore.tsstate/store.tsutils/config.tsutils/settings/settings.tscommands.ts plus commands/*.
Responsibility: human-triggered slash and local commands.Tool.ts, tools.ts, tools/*.
Responsibility: model-callable tool contracts, schemas, concurrency behavior, UI, and registration.query.ts, QueryEngine.ts, services/tools/*, services/api/claude.ts.
Responsibility: turn execution, streaming, compacting, retry behavior, tool orchestration, and provider interaction.screens/REPL.tsx, components/*, hooks/*, ink/*.
Responsibility: interactive rendering, prompt input, dialogs, task views, and notifications.services/*, bridge/*, remote/*, upstreamproxy/*.
Responsibility: MCP, analytics, OAuth, remote managed settings, bridge and CCR, plugin operations, policy limits, and other integrations.utils/*, types/*, constants/*, schemas/*.
Responsibility: filesystem, git, session storage, permissions, plugins, telemetry, text processing, and shared schemas.Tool.ts defines the shared tool contract and ToolUseContext.ToolUseContext carries the current tools, commands, MCP clients and resources, app state getters and setters, permission context, messages, and turn-scoped helpers.ToolPermissionContext is the normalized permission state passed through the runtime.state/AppStateStore.ts defines AppState.QueryEngineConfig in QueryEngine.ts describes the long-lived conversation owner for headless and SDK flows.QueryParams in query.ts describes one low-level turn.QueryEngine owns conversation persistence across turns; query.ts owns one agentic turn.utils/settings/types.ts defines SettingsJson, PermissionsSchema, environment variable schema, marketplace schema, and MCP allow and deny entries.utils/settings/settings.ts loads, merges, caches, validates, and updates those settings across sources.utils/config.ts defines ProjectConfig and GlobalConfig.services/mcp/types.ts defines transport schemas such as stdio, sse, http, ws, and sdk, plus scope values and runtime connection states.services/mcp/config.ts builds the merged MCP config set.services/mcp/client.ts turns config into live connections plus tool, resource, and command exposure.| Module | Incoming imports |
|---|---|
ink.ts | 429 |
utils/debug.ts | 370 |
services/analytics/index.ts | 264 |
bootstrap/state.ts | 260 |
utils/errors.ts | 248 |
utils/log.ts | 243 |
utils/envUtils.ts | 220 |
utils/slowOperations.ts | 206 |
utils/config.ts | 155 |
utils/settings/settings.ts | 138 |
utils/messages.ts | 134 |
services/analytics/growthbook.ts | 131 |
state/AppState.tsx | 108 |
utils/cwd.ts | 104 |
utils/auth.ts | 104 |
utils/format.ts | 102 |
utils/fsOperations.ts | 96 |
utils/lazySchema.ts | 95 |
keybindings/useKeybinding.ts | 94 |
utils/stringUtils.ts | 82 |
Interpretation:
ink.ts is the UI facade shared throughout the interactive client.bootstrap/state.ts, Tool.ts, and commands.ts are system-wide contracts.utils/debug.ts, utils/errors.ts, utils/log.ts, and utils/config.ts are pervasive platform helpers.services/analytics/index.ts is cross-cutting because feature flags and telemetry are consulted all over the runtime.main.tsx -> dialogLaunchers.tsx -> interactiveHelpers.tsx -> main.tsx. This exists because startup helpers and one-off dialog launchers are split out of main.tsx but still need its deferred prefetch helper.utils/stats.ts <-> utils/statsCache.ts. Small helper and cache pair.tools/RemoteTriggerTool/*, tools/SendMessageTool/*, tools/TeamCreateTool/*, and tools/TeamDeleteTool/*.