CrewCode 0.2.1

feat: implement custody journal for agent execution tracking

• Add CustodyJournal class to manage execution records with atomic persistence.
• Introduce CustodyRecord interface to define the structure of custody records.
• Implement recovery logic for interrupted turns and handle various custody states.
• Create tests for CustodyJournal to ensure correct behavior during recovery and state management.

feat: add custody service for Electron integration

• Create custody service to manage journal access and authority verification.
• Implement scopeKeyFor and authorityOf functions to handle session keys and authority normalization.
• Add scopeViolation function to check the validity of granted workspace roots.

feat: develop custody halt banner component

• Implement CustodyHaltBanner component to display halt notifications with preserved evidence.
• Provide user feedback for reauthorization actions and display relevant details about the halt.

feat: enhance crew integration presentation logic

• Create functions to present crew integration status with user-friendly messages.
• Implement tests to verify the presentation logic for different integration states.

feat: introduce crew review fingerprinting

• Implement crewReviewFingerprint function to track changes in lane ownership.
• Ensure that runtime status updates do not affect the review evidence display.

chore: add shared custody types for consistency

• Define custody invariant types and violation structures for shared use across main and renderer processes.

CrewCode

Initial public release of CrewCode 0.2.0

CrewCode is a desktop ACE (Agent Coding Environment) for running and

supervising multiple AI coding agents across local git worktrees.

Install

Linux — download the AppImage, then:
chmod +x CrewCode-0.2.0-linux-x86_64.AppImage
./CrewCode-0.2.0-linux-x86_64.AppImage

Or install the .deb:
sudo dpkg -i CrewCode-0.2.0-linux-amd64.deb

macOS — download the .dmg for your chip (arm64 for Apple Silicon, x64 for Intel).
The build is not notarized yet, so Gatekeeper will block it on first open.
Right-click the app → Open → Open, or:
xattr -cr /Applications/CrewCode.app

Windows — run the .exe installer. SmartScreen will warn on an unsigned
binary; click "More info" → "Run anyway". A portable .exe is also attached.

What's in it

• Run CrewCoder, Claude Code, Codex, OpenCode, pi, Hermes, Ollama, and OpenRouter from one app
• Each agent gets its own git worktree, chat session, terminal panes, and editor
• Supervisor mode: one agent delegates to others, with incremental reporting
• Split and broadcast task distribution across agent lanes
• Provider switching mid-session with an AI-generated handoff summary
• /compact to summarize a long session and continue in a fresh context
• Code editor on CodeMirror 6 with TypeScript/JavaScript LSP, themes, and outline
• Git workspace: stage, commit, branch, push (with auth prompt)
• Workbench mode for multiple chats and terminals on one worktree
• Local plugin platform — sandboxed iframe panels, permission-gated capabilities
• SSH remote workspaces
• Writer workspace with DOCX/PDF conversion review

Known limitations

• Binaries are not code-signed or notarized (see install notes above)
• Editor intelligence (LSP) covers TypeScript/JavaScript only
• SSH remote workspaces are less tested than local ones
• Plugin API is v0 and will change before it stabilizes
• No auto-update yet

Requirements

Agent CLIs are not bundled — install the ones you want separately
(crewcoder, claude, codex, opencode, pi, hermes, ollama). CrewCode detects them on PATH.

License

Apache-2.0. Bundled Bearded Icons are GPL-3.0 — see NOTICE.