Skip to content

docs: add CLAUDE.md for Claude Code guidance#23

Merged
itamaker merged 1 commit into
mainfrom
docs/add-claude-md
Jun 8, 2026
Merged

docs: add CLAUDE.md for Claude Code guidance#23
itamaker merged 1 commit into
mainfrom
docs/add-claude-md

Conversation

@itamaker

@itamaker itamaker commented Jun 8, 2026

Copy link
Copy Markdown
Owner

Summary

Adds a CLAUDE.md to give future Claude Code instances a fast on-ramp to this repo.

It documents:

  • Commandsmake build/test/release-check/snapshot, running a single test, and go run for CLI/GUI/dry-run.
  • Architecture — the key non-obvious points:
    • The three cmd/ entrypoints map to different release builds: cmd/go-chrome-ai (CGO, macOS, includes Fyne GUI) vs cmd/cli (CGO_ENABLED=0, portable Linux/Windows, CLI-only) vs cmd/gui (dev).
    • chrome.Run(Options, Callbacks) is the single OS-agnostic engine both frontends drive via Callbacks{Log, Progress}.
    • Local State patch transforms (recursive is_glic_eligible, variations fields, @2=Disabled flag encoding).
    • Build-tagged per-OS policy stores (policy_{darwin,linux,windows}.go).
  • Conventions — preview-then-apply for destructive actions; output/ vs dist/.

🤖 Generated with Claude Code

Document build/test commands and the high-level architecture: the
three cmd/ entrypoints and their per-platform release builds, the
shared chrome.Run engine driven via Callbacks, the Local State patch
transforms, and the build-tagged per-OS policy stores.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@itamaker
itamaker merged commit 125b10d into main Jun 8, 2026
1 check passed
@itamaker
itamaker deleted the docs/add-claude-md branch June 8, 2026 07:11
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant