Skip to content
Claude Code Internal Analysis

What is the reverse-engineered cli.js artifact?

This page defines the artifact boundary for reverse-engineering how Claude Code works.

cli.js is the readable JavaScript entrypoint extracted from the Linux x64 Bun standalone package for @anthropic-ai/claude-code@2.1.143. It is not the original TypeScript source tree: it is bundled, minified, and paired with JavaScriptCore bytecode in the same Bun module graph.

For day-to-day reading, this repo publishes a derived view claude-code-pkg/src/entrypoints/cli.renamed.js produced by scripts/normalize-cli-js.mjs and scripts/semantic-rename-cli.mjs. It has identical runtime behavior to cli.js but with semantic identifier names recovered from export tables, runtime class names, dispatch handlers, string constants, and call-path property aliases. Source-anchor tables across this wiki reference the renamed view.

Source anchors

Semantic aliasAnchorMeaning
FinalArtifactExtractorTRAILER, MODULE_RECORD_SIZE, FINAL_ROOT_FILESParses the Bun graph in memory and keeps only selected JS files.
BunEntrypointWrapper// @bun @bytecode @bun-cjsBun CommonJS wrapper emitted for the entrypoint.
EmbeddedProductVersionVERSION:"2.1.143"Embedded product version used by version output and runtime metadata.
OuterBootstrapasync function J9AOuter bootstrap function reached by the Bun standalone executable.
ImageProcessorShimrequire("/$bunfs/root/image-processor.node")Thin wrapper around an embedded N-API image module.
AudioCaptureShimrequire("/$bunfs/root/audio-capture.node")Thin wrapper around an embedded N-API audio module.

Artifact stack

flowchart TD
    Npm[wrapper npm package] --> Native[platform native package]
    Native --> Elf[Linux x64 Bun standalone ELF]
    Elf --> BunSection[.bun section]
    BunSection --> Graph[StandaloneModuleGraph]
    Graph --> Cli[src/entrypoints/cli.js]
    Graph --> Image[image-processor.js]
    Graph --> Audio[audio-capture.js]
    Graph -. pruned .-> NativeAddons[embedded .node addons]
    Graph -. not retained .-> Jsc[JavaScriptCore bytecode]

The Bun payload contains five modules, but the final retained package keeps only the readable JavaScript files:

ModuleRole
claude-code-pkg/src/entrypoints/cli.jsThe main bundled runtime: command parsing, TUI, headless runner, tools, sessions, MCP, plugins, agents, auth, models, telemetry, and updates.
claude-code-pkg/image-processor.jsCommonJS shim that refers to /$bunfs/root/image-processor.node; the native addon is not retained in this repo layout.
claude-code-pkg/audio-capture.jsCommonJS shim that refers to /$bunfs/root/audio-capture.node; the native addon is not retained in this repo layout.

What cli.renamed.js owns

Reverse-engineering cli.renamed.js shows it is the central agent runtime rather than a thin argument parser. Confirmed top-level ownership includes:

  • Bun/bootstrap and product-version fast paths.
  • Commander root command, root flags, and utility subcommands.
  • Interactive TUI/session loop and resume picker.
  • Print/headless runner, stream-JSON I/O, SDK transport, and control frames.
  • Prompt/context inputs such as CLAUDE.md, settings, system-prompt flags, output styles, agents, skills, and MCP.
  • Model/provider/auth selection across first-party, Bedrock, Vertex, Foundry, Anthropic AWS, Mantle, and API-key/OAuth paths.
  • Built-in tools, permissions, hooks, MCP, plugins, IDE/Chrome integration, and settings policy.
  • Local JSONL transcripts, resume/continue/fork/rewind, remote sessions, teleport, and Remote Control.
  • Agents, subagents, task tools, background agents, ultrareview, and auto-mode.
  • Diagnostics, debug logs, telemetry/traffic gates, native updater, and media native modules.

What it is not

  • It is not clean source with original module names.
  • It is not sourcemap-backed; temporary Bun graph inspection found no serialized sourcemap payload for this build.
  • JavaScriptCore cached bytecode can be dumped for instruction-level research, but bytecode dumps are no longer retained as final artifacts and do not recover the original JavaScript/TypeScript.
  • Minified anchors behind aliases such as TopLevelMain, CommanderRoot, HeadlessRunner, and InteractiveSessionLoop are version-specific. Use them only with exact string/offset anchors.

Created and maintained by Yingting Huang.