Skip to content

Latest commit

 

History

History
69 lines (48 loc) · 2.64 KB

cli-metadata.md

File metadata and controls

69 lines (48 loc) · 2.64 KB

Feature: Claude Code CLI Metadata

Links: Architecture: docs/Architecture/Overview.md Modules: ClaudeClient.cs, ClaudeCliMetadataReader.cs, ClaudeCliMetadata.cs Source of truth: local claude CLI behavior + upstream anthropics/claude-code tags and settings layout

Purpose

Expose runtime Claude Code CLI metadata to SDK consumers:

  • installed claude version
  • default model configured in local Claude config
  • SDK-known Claude model aliases/constants
  • update availability status vs latest upstream tagged Claude Code version

The repository's upstream sync workflow separately tracks source changes in anthropics/claude-code.

Scope

In scope

  • ClaudeClient.GetCliMetadata() public API.
  • ClaudeClient.GetCliUpdateStatus() public API.
  • Reading version from claude --version.
  • Reading default model from Claude settings discovery (.claude/settings.local.json, .claude/settings.json, ~/.claude/settings.json) with SDK fallback alias sonnet.
  • Reading latest upstream tagged version from https://github.com/anthropics/claude-code.git.
  • Returning claude update in update status when a newer upstream tag exists.

Out of scope

  • Remote model discovery over Anthropic APIs.
  • Mutating user Claude config files.
  • Replacing Claude Code CLI model selection logic.

Business Rules

  • Metadata read is read-only and does not mutate local Claude state.
  • SDK option and metadata decisions are based on real Claude Code CLI behavior, not any separate SDK surface.
  • Update check failures (for example missing git or network access) must return actionable status messages and never silently fail.
  • The upstream sync watcher must raise a repository issue when anthropics/claude-code moves ahead of the pinned submodule SHA.

Diagram

flowchart LR
  Client["ClaudeClient.GetCliMetadata()"] --> Version["claude --version"]
  Client --> Update["ClaudeClient.GetCliUpdateStatus()"]
  Client --> Config[".claude/settings.local.json /.claude/settings.json / ~/.claude/settings.json"]
  Update --> Git["git ls-remote --tags anthropics/claude-code"]
  Version --> Metadata["ClaudeCliMetadata"]
  Git --> UpdateStatus["ClaudeCliUpdateStatus"]
  Config --> Metadata
Loading

Verification