# Build Documentation

> Reference for the Build Electron IDE: multi-harness agent orchestration, sessions, IPC APIs, provider configuration, semantic search, browser preview, and build/release workflows for contributors.

This is a Grok-Wiki source-grounded repository documentation set. Use the complete Markdown link when an agent needs the full repo context.

## Context Links

- [Complete Markdown docs](https://grok-wiki.com/public/docs/parcha-ai-build-bea5702b371b/llms-full.txt)
- [Complete Markdown alias](https://grok-wiki.com/public/docs/parcha-ai-build-bea5702b371b.md)
- [Human interactive docs](https://grok-wiki.com/public/docs/parcha-ai-build-bea5702b371b)
- [GitHub repository](https://github.com/Parcha-ai/build)

## Repository

- Repository: Parcha-ai/build

- Generated: 2026-06-02T00:27:44.703Z
- Updated: 2026-06-02T02:29:22.684Z
- Runtime: Grok CLI
- Format: Documentation
- Pages: 24

## Pages

- [Overview](https://grok-wiki.com/public/docs/parcha-ai-build-bea5702b371b/pages/01-overview.md): What Build exposes as a desktop IDE, primary entry points (sessions, harness picker, Auto Build), BYOC/BYOK assumptions, and the shortest path from install to first agent turn.
- [Installation](https://grok-wiki.com/public/docs/parcha-ai-build-bea5702b371b/pages/02-installation.md): macOS release download, from-source prerequisites (Node, npm, Electron native deps), npm install, and environment separation between production and dev user data.
- [Quickstart](https://grok-wiki.com/public/docs/parcha-ai-build-bea5702b371b/pages/03-quickstart.md): Open a project folder, store an API key, pick a harness or Auto Build, send the first message, and verify success via chat stream, terminal output, or status bar version.
- [Electron process model](https://grok-wiki.com/public/docs/parcha-ai-build-bea5702b371b/pages/04-electron-process-model.md): Main vs renderer boundaries, service layout under src/main/services, webpack packaging, custom protocols (monaco-asset), CDP ports, and dev vs production userData paths.
- [Harnesses and models](https://grok-wiki.com/public/docs/parcha-ai-build-bea5702b371b/pages/05-harnesses-and-models.md): Supported harness identifiers (claude, codex, cursor, gemini, opencode, custom), model picker strings, permission modes per harness, and harness capability limits for injection and multi-turn.
- [Sessions and workspaces](https://grok-wiki.com/public/docs/parcha-ai-build-bea5702b371b/pages/06-sessions-and-workspaces.md): Session schema, lifecycle statuses, Docker vs local dev vs SSH vs OpenClaw, worktrees, forks, transcript resumption, and electron-store persistence (claudette-sessions).
- [Auto Build routing](https://grok-wiki.com/public/docs/parcha-ai-build-bea5702b371b/pages/07-auto-build-routing.md): Plan/build/verify/refine tiers, heuristic vs Flue controller routing, orchestration plans, mission control policies, failure cooldowns, and CLAUDE_AUTO_ROUTE_DECISION events.
- [IPC and preload bridge](https://grok-wiki.com/public/docs/parcha-ai-build-bea5702b371b/pages/08-ipc-and-preload-bridge.md): How ipcMain handlers map to renderer window.electronAPI, typed channel constants, event vs invoke patterns, and secure contextBridge exposure in preload.ts.
- [Configure API keys and providers](https://grok-wiki.com/public/docs/parcha-ai-build-bea5702b371b/pages/09-configure-api-keys-and-providers.md): Store Anthropic, OpenAI, Google, Foundry, Cursor, DeepSeek, and custom proxy models; provider CLI detection; secure key interception; and optional PostHog analytics keys.
- [Manage coding sessions](https://grok-wiki.com/public/docs/parcha-ai-build-bea5702b371b/pages/10-manage-coding-sessions.md): Create, start, stop, fork, and rewind sessions; teleport/import flows; message queue coalescing; permission and plan approval dialogs; and session switcher UX.
- [SSH remote sessions](https://grok-wiki.com/public/docs/parcha-ai-build-bea5702b371b/pages/11-ssh-remote-sessions.md): SSHConfig fields, connection test, remote workdir setup scripts, resume candidates, download/teleport session flows, and detached bridge recovery.
- [Git workflows in Build](https://grok-wiki.com/public/docs/parcha-ai-build-bea5702b371b/pages/12-git-workflows-in-build.md): Per-session worktree git operations: status, diff, commit, push/pull, branch watch events, and GitExplorer UI bindings to git IPC channels.
- [Browser preview and inspection](https://grok-wiki.com/public/docs/parcha-ai-build-bea5702b371b/pages/13-browser-preview-and-inspection.md): In-window webview navigation, CDP attachment per session, DOM inspector injection, snapshots, console/network capture, and Stagehand integration for agent-driven browsing.
- [MCP servers](https://grok-wiki.com/public/docs/parcha-ai-build-bea5702b371b/pages/14-mcp-servers.md): Install stdio/http/sse MCP servers from the registry marketplace, claudette-mcp-servers store schema, harness sync to Cursor/Gemini/Codex/OpenCode, and runtime loading into Claude Agent SDK.
- [Semantic search (QMD)](https://grok-wiki.com/public/docs/parcha-ai-build-bea5702b371b/pages/15-semantic-search-qmd.md): Opt-in QMD indexing via Bun bundle, collection creation, embedding generation, search IPC, project preferences, and setup-qmd dev/build integration.
- [Voice and audio](https://grok-wiki.com/public/docs/parcha-ai-build-bea5702b371b/pages/16-voice-and-audio.md): ElevenLabs conversational voice mode, OpenAI realtime transcription, TTS streaming IPC, microphone permissions on macOS, and optional API keys for audio providers.
- [Extensions, skills, and slash commands](https://grok-wiki.com/public/docs/parcha-ai-build-bea5702b371b/pages/17-extensions-skills-and-slash-commands.md): Scan project/user commands, skills, and agents; install skills from marketplace; plugin marketplaces; GStack workflow modes; and command autocomplete in chat.
- [Settings reference](https://grok-wiki.com/public/docs/parcha-ai-build-bea5702b371b/pages/18-settings-reference.md): AppSettings and electron-store keys in claudette-settings: theme, fonts, QMD, ultra plan, reminders, GStack, Foundry, focus tasks, customModels, and autoRouterConfig defaults.
- [IPC channels reference](https://grok-wiki.com/public/docs/parcha-ai-build-bea5702b371b/pages/19-ipc-channels-reference.md): Complete IPC_CHANNELS catalog grouped by domain (auth, session, claude, browser, git, mcp, qmd, ssh, voice, analytics) with invoke vs push event semantics.
- [Auto Build configuration reference](https://grok-wiki.com/public/docs/parcha-ai-build-bea5702b371b/pages/20-auto-build-configuration-reference.md): AutoRouterConfig fields (planModel, buildModel, verifyModel, refineModel, categories, costAware), MetaHarnessPolicy options, and npm verify:auto-router:* regression scripts.
- [Shared types reference](https://grok-wiki.com/public/docs/parcha-ai-build-bea5702b371b/pages/21-shared-types-reference.md): Core exported interfaces: Session, ChatMessage, RoutingDecision, OrchestrationPlan, Harness, PermissionRequest, MCP types, and message-queue HarnessCapabilities.
- [npm scripts reference](https://grok-wiki.com/public/docs/parcha-ai-build-bea5702b371b/pages/22-npm-scripts-reference.md): package.json scripts: start, lint, make, setup-qmd, verify:auto-router:* suite, and when to use ./scripts/dev.sh vs npm run start directly.
- [Build and release](https://grok-wiki.com/public/docs/parcha-ai-build-bea5702b371b/pages/23-build-and-release.md): electron-forge make output paths, version bump rules, git tagging, dual remotes (origin/public), /build and /release slash-command workflows, and GitHub release artifacts.
- [Troubleshooting](https://grok-wiki.com/public/docs/parcha-ai-build-bea5702b371b/pages/24-troubleshooting.md): Dev instance port conflicts, PATH/node discovery in packaged apps, CDP timeouts, MCP harness sync errors, SSH bridge recovery, production main.log location, and security reporting.

## Source Files

- `.claude/commands/build.md`
- `.claude/commands/dev.md`
- `.claude/commands/release.md`
- `.notes/cdp-navigation-timeout-investigation.md`
- `.notes/cdp-proxy-hardening-summary.md`
- `.notes/ssh-download-implementation-summary.md`
- `CLAUDE.md`
- `entitlements.mac.plist`
- `forge.config.ts`
- `package.json`
- `README.md`
- `scripts/build.sh`
- `scripts/dev.sh`
- `scripts/setup-qmd.ts`
- `scripts/verify-auto-router-goal-orchestration.ts`
- `scripts/verify-auto-router-meta-harness.ts`
- `scripts/verify-auto-router-plan-mode.ts`
- `scripts/verify-mcp-harness-sync.ts`
- `scripts/verify-mcp-runtime-matrix.js`
- `scripts/verify-ssh-detached-bridge-resume.js`
- `SECURITY.md`
- `src/main/index.ts`
- `src/main/ipc/analytics.ipc.ts`
- `src/main/ipc/audio.ipc.ts`
- `src/main/ipc/browser.ipc.ts`
- `src/main/ipc/claude.ipc.ts`
- `src/main/ipc/extension.ipc.ts`
- `src/main/ipc/git.ipc.ts`
- `src/main/ipc/mcp.ipc.ts`
- `src/main/ipc/qmd.ipc.ts`
- `src/main/ipc/queue.ipc.ts`
- `src/main/ipc/secure-keys.ipc.ts`
- `src/main/ipc/session.ipc.ts`
- `src/main/ipc/settings.ipc.ts`
- `src/main/ipc/ssh.ipc.ts`
- `src/main/ipc/voice.ipc.ts`
- `src/main/preload.ts`
- `src/main/services/audio.service.ts`
- `src/main/services/auto-router.service.ts`
- `src/main/services/browser.service.ts`
- `src/main/services/cdp-proxy.service.ts`
- `src/main/services/codex.service.ts`
- `src/main/services/docker.service.ts`
- `src/main/services/elevenlabs-voice.service.ts`
- `src/main/services/extension.service.ts`
- `src/main/services/flue-meta-router.service.ts`
- `src/main/services/git.service.ts`
- `src/main/services/gstack.service.ts`
- `src/main/services/harness-capabilities.ts`
- `src/main/services/harness-policy.service.ts`
- `src/main/services/mcp.service.ts`
- `src/main/services/message-queue.service.ts`
- `src/main/services/opencode.service.ts`
- `src/main/services/plugin.service.ts`
- `src/main/services/qmd.service.ts`
- `src/main/services/realtime.service.ts`
- `src/main/services/secure-keys.service.ts`
- `src/main/services/session.service.ts`
- `src/main/services/settings.service.ts`
- `src/main/services/ssh.service.ts`
- `src/main/services/stagehand.service.ts`
- `src/main/services/transcript.service.ts`
- `src/renderer/App.tsx`
- `src/renderer/components/chat/AutoRouteBadge.tsx`
- `src/renderer/components/chat/CommandAutocomplete.tsx`
- `src/renderer/components/chat/ForkTabs.tsx`
- `src/renderer/components/chat/InputArea.tsx`
- `src/renderer/components/chat/MessageQueuePanel.tsx`
- `src/renderer/components/chat/VoiceMode.tsx`
- `src/renderer/components/extensions/MCPInstallDialog.tsx`
- `src/renderer/components/extensions/MCPMarketplace.tsx`
- `src/renderer/components/extensions/UnifiedMarketplace.tsx`
- `src/renderer/components/git/GitExplorer.tsx`
- `src/renderer/components/onboarding/ApiKeyOnboarding.tsx`
- `src/renderer/components/preview/BrowserPreview.tsx`
- `src/renderer/components/qmd/QMDPrompt.tsx`
- `src/renderer/components/session/DownloadSessionDialog.tsx`
- `src/renderer/components/session/NewSessionDialog.tsx`
- `src/renderer/components/session/SessionList.tsx`
- `src/renderer/components/session/SSHConfigForm.tsx`
- `src/renderer/components/settings/SettingsDialog.tsx`
- `src/renderer/monaco-config.ts`
- `src/renderer/stores/session.store.ts`
- `src/shared/constants/channels.ts`
- `src/shared/types/index.ts`
- `src/shared/types/message-queue.ts`
- `src/shared/utils/message-recovery.ts`
- `src/shared/utils/prompt-truncation.ts`
- `TEST_RESULTS_v0043.md`
- `webpack.main.config.ts`
- `webpack.renderer.config.ts`