This repository is primarily set up for local development, building, and testing.

Requirements:

• Bun 1.3+
• Node.js 18+
• macOS for GUI automation work and bun run smoke:gui

Install dependencies:

bun install

Run from source:

bun run dev

Useful variants:

bun run dev -- --help
bun run dev -- --version

bun run dev executes src/entrypoints/cli.tsx with scripts/dev-preload.mjs, so local workspace packages are used directly during development.

Build the CLI:

bun run build

Build output is written to dist:

• dist/claude
• dist/src-build/cli.js

Clean generated output:

bun run clean

Standard smoke test:

bun run smoke

GUI smoke test:

bun run smoke:gui

Recommended validation sequence:

bun install
bun run build
bun run smoke
bun run smoke:gui

The standard smoke test currently verifies:

• build success
• ./dist/claude --version
• node bin/claude.js --version
• ./dist/claude --help
• ./dist/claude auth status --text
• ./dist/claude plugin list
• ./dist/claude mcp list
• ./dist/claude agents
• workspace package loading
• computer-use MCP server initialization

The GUI smoke test currently verifies:

1. build
2. GUI permission preflight
3. frontmost app and mouse position checks
4. package-backed screenshot capture
5. executor screenshot
6. mouse move and restore
7. key press and release
8. opening TextEdit, creating a document, inserting a fixed test string, and verifying the document content

Permissions involved:

• Accessibility
• Screen Recording

If Screen Recording is granted during the run, macOS may still require restarting the terminal before the GUI smoke test can fully pass.

The main local workspace packages involved in development and smoke coverage are:

• audio-capture-napi
• claude-for-chrome-mcp
• computer-use
• computer-use-input
• computer-use-mcp
• image-processor-napi
• modifiers-napi
• url-handler-napi

• src: main CLI source
• packages: local workspace packages
• scripts: build, development, and smoke-test scripts
• bin: launcher entrypoint
• vendor: vendored helper binaries such as fallback ripgrep

• The repository is documented as VideCoding CLI, but the current runtime identifiers and binary paths still use claude naming internally.
• Actual model use still requires a valid login state.
• GUI validation depends on a real macOS desktop session with the required permissions.