Skip to content

README.en.md

Latest commit

 

History

History
82 lines (59 loc) · 5.82 KB

README.en.md

File metadata and controls

82 lines (59 loc) · 5.82 KB

Claude Code Source Snapshot Reconstruction and Run Guide

中文

This repository is a minimally runnable reconstruction built from a publicly accessible Claude Code source snapshot. Its purpose is to make startup verification, source inspection, and architecture research easier.

Getting started is straightforward:

bun install
bun run start

Buddy Usage

This reconstructed snapshot includes a minimal working buddy feature. After the CLI starts, you can use these REPL commands:

/buddy
/buddy status
/buddy reroll
/buddy pet
/buddy mute
/buddy unmute

Typical flow:

  1. Run /buddy once to hatch a companion and persist it into ~/.claude.json
  2. Run /buddy status to inspect the current buddy name, species, rarity, mute state, and personality
  3. Run /buddy reroll to roll a new buddy and update the persisted companion seed in ~/.claude.json
  4. Run /buddy pet to trigger a petting reaction with hearts and a speech bubble
  5. Run /buddy mute or /buddy unmute to disable or restore buddy visibility and reactions
  6. Mention the buddy by name in chat and it will produce a short speech-bubble reaction after the turn

Notes:

  • This is a minimally reconstructed buddy implementation, not guaranteed to match Anthropic's original internal behavior exactly
  • Buddy is enabled by default in source mode; set CLAUDE_CODE_ENABLE_BUDDY=0 before startup if you want to disable it

Detailed reconstruction notes (Chinese): docs/reconstruction-process.md

Claude Code Startup Screen

Current status: the core CLI / REPL path is runnable and suitable for research and startup validation, but this is still not a 1:1 copy of the official release repository. Some build artifacts, generated files, and internal capabilities remain reconstructed, placeholder-based, or degraded.

Current Status

Category Status Notes Related Files
CLI startup path Verified working bun run start, bun run help, --version, and the REPL landing screen have been verified src/entrypoints/cli.tsx src/setup.ts
Welcome screen and startup info Verified working Tips for getting started, Recent activity, and medium · /effort render correctly src/utils/logoV2Utils.ts src/projectOnboardingState.ts tools/runtime-preload.ts
Local session history Verified working Recent activity can read and display local session history src/utils/logoV2Utils.ts
Core source tree Mostly complete Core areas such as CLI dispatch, command loading, REPL UI, session storage, and tool plumbing are present, but not every command or provider branch has been regression-tested src/entrypoints/cli.tsx src/setup.ts
Build and release layer Reconstructed The current project files were added to make the snapshot minimally runnable and do not represent the original release repository package.json tsconfig.json bunfig.toml tools/runtime-preload.ts
Generated SDK types Placeholder These files are placeholders rather than original generated artifacts src/entrypoints/sdk/coreTypes.generated.ts src/entrypoints/sdk/runtimeTypes.ts src/entrypoints/sdk/toolTypes.ts
Bundled verify skill Degraded The current content is a fallback simplification, not the original inlined bundle output src/skills/bundled/verifyContent.ts
Chrome integration Degraded Falls back to a static tool-name list when the internal package is unavailable src/utils/claudeInChrome/browserTools.ts
Tungsten Unavailable Explicitly disabled in the public source snapshot src/tools/TungstenTool/TungstenTool.ts src/tools/TungstenTool/TungstenLiveMonitor.tsx
ripgrep Compatibility fallback Prefers a system rg fallback instead of the original bundled form src/utils/ripgrep.ts
Child process execution layer Compatibility patch Adjusted to match the currently installed dependency behavior src/utils/execFileNoThrow.ts

Commands Currently Stubbed or Unavailable

Category Content
Stub commands debug-tool-call, share, summary, onboarding, bughunter, oauth-refresh, good-claude, mock-limits, ant-trace, issue, autofix-pr, reset-limits, teleport, env, perf-issue, break-cache, backfill-sessions, ctx_viz
Representative files src/commands/share/index.js src/commands/onboarding/index.js src/commands/autofix-pr/index.js

Overall Conclusion

This repository can now be treated as a "high-completeness source snapshot plus runnable reconstruction":

  • It is suitable for startup verification, source reading, architectural analysis, and CLI / REPL behavior research.
  • It is not equivalent to the official full repository or the original build environment.
  • The main remaining gaps are the original build/release layer, generated artifacts, and some private internal integrations and commands.

Disclaimer

  • The original source code remains the property of Anthropic.
  • This repository is provided for technical research and learning purposes only.
  • If any content is infringing, please contact for removal.