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 scripts/dev.ts, which builds src/entrypoints/cli.tsx into dist/src-build/cli.js and runs that bundle with the shared feature configuration used by the build pipeline.

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

Testing scope and stop-rule are documented in TESTING.md.

Unit and integration tests:

bun run test

Coverage report:

bun run test:coverage

Standard smoke test:

bun run smoke

GUI smoke test:

bun run smoke:gui

Test layering:

• bun run test: source-level tests for modules, handlers, and entrypoints
• bun run smoke: built-artifact smoke checks in the current machine environment
• bun run smoke:gui: macOS desktop smoke checks

Recommended validation sequence:

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

The standard smoke test currently verifies:

• build success
• ./dist/claude --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
• 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.