All notable changes to the Collagility project will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
- Pane Persistence & Panel Closure Fix:
- Enabled
remain-on-exitinTmuxSessionand wrapped left pane execution in a persistent shell fallback (bash -c "... || exec bash"), guaranteeing the left pane panel never closes automatically under any circumstance. - Added global
uncaughtExceptionandunhandledRejectiontraps to prevent unexpected background errors from terminating the Node process. - Fixed
Ctrl+Cbehavior in React Ink TUI soCtrl+Ccloses active overlays/prompts or clears input instead of killing the session.
- Enabled
- CLI Entrypoint Invocation: Removed fragile
process.argv[1].endsWith('main.js')check inapps/cli/src/main.tsthat caused global NPM binary commands (collagility,collagility help,collagility server start) to silently exit without executing.
- NPM Package Publishing Fix: Moved
@collagility/*monorepo packages todevDependenciesinapps/cli/package.jsonto prevent NPMEUNSUPPORTEDPROTOCOLerrors onworkspace:*dependencies duringnpm install -g collagility. - Session Type Safety: Added missing
workspacePathrequirement to mock Session instances in server unit tests to ensure strict TypeScript type compliance.
- Session Type Safety: Added missing
workspacePathrequirement to mock Session instances in server unit tests to ensure strict TypeScript type compliance.
- Comprehensive User Guide: Added
docs/GUIDE.mddetailing architecture, configuration, installation, troubleshooting, CLI command & flag reference, security modes, and LAN collaboration setup. - Private Vulnerability Reporting: Updated
SECURITY.mdto point security disclosures to GitHub Private Vulnerability Reporting.
- System Requirements: Updated required Node.js version to
>=22.0.0and pnpm to>=9.0.0across README, INSTALL guide, and User Guide. - Server Bind Defaults: Documented default
0.0.0.0:8080binding behavior for seamless local network (LAN) accessibility out-of-the-box.
- 1:1 Unbuffered AI Screenshare Streaming: Real-time byte-by-byte terminal streaming from host right pane into joined visitors using
tail -fscreenshare logs with 0 token cost to visitors. - Real Host IP Join Guidance:
collagility startnow automatically detects real LAN IPv4 address and displayscollagility join session@192.168.1.50instructions. - Chronological Timeline Sorting: Fixed activity logs and system notifications to sort chronologically by timestamp.
- Short Collaborator IDs: Truncated 36-char UUIDs to 8-char short IDs (
2138c10c) to prevent text wrapping on narrow panes. - Graceful Ctrl+C Exit: Restored
Ctrl+Chandling in Ink TUI to gracefully disconnect WebSocket sessions, terminate tmux split sessions, and exit cleanly.
- Global Shell Installers: Added cross-platform
install.sh(curl | bashfor macOS/Linux) andinstall.ps1(iwrfor Windows PowerShell) for automated Node.js environment checks and global CLI installation. - NPM Beta Release Setup: Configured package metadata (
collagility), executable entrypoint (bin: { "collagility": "./dist/main.js" }), andscripts/publish-beta.sh. - Composite Join Tokens: Added support for
collagility join session@192.168.1.50targets without typing--serverflags. - Smart Server URL Normalization: Automatically normalizes bare IPs (
192.168.1.50), host:port (192.168.1.50:8080), http, and ws URLs. - Persistent User Configuration: Added
~/.collagility/config.jsonstorage andcollagility config set server <ip>command.
- Google Antigravity CLI (
agy) Adapter: Integrated nativeAntigravityAdapterin@collagility/adapterssupporting non-interactiveagyprocess execution, stdout/stderr event parsing, thought streaming blocks, and subagent dispatcher events (SUBAGENT_SPAWNED,SUBAGENT_PROGRESS,SUBAGENT_COMPLETED). - Security Permission Engine & Ink Cards: Added
evaluateRiskcommand classifier inrisk-evaluator.ts(LOW,MEDIUM,HIGH) and interactive Ink permission approval cards (PermissionPromptCard.tsx) with hotkeys (y/n/e). - Subagent Monitoring Drawer: Created
SubagentDrawer.tsxrendering active background worker threads, current tool name, and progress percentages, toggled viaCtrl+Kor/agents. - Model Context Protocol (MCP) Loader: Added
mcp-loader.tsto discover local.mcp.jsonand global~/.gemini/antigravity-cli/mcp.jsonconfigs with interactive/mcpoverlay. - Conversation Checkpointing & Session Resumption: Implemented disk state persistence in
.collagility/sessions/<sessionId>.json,/rewind [steps],/fork,/resume, andcollagility start --resume <sessionId>. - Real-Time Permission Synchronization: Added WebSocket event schemas (
SESSION_PERMISSION_REQUEST,SESSION_PERMISSION_RESPONSE) to synchronize permission prompts across session host and remote clients.
- React Ink TUI Redesign: Redesigned UI layout in
apps/clito match Google Antigravity CLI styling, adding top workspace header banner, real-time connection badge,@path autocomplete popup box, double-escape (Esc Esc) input clearing, andShift+Tabsecurity mode cycling.
- Monorepo infrastructure setup with
pnpmworkspaces and TurboRepo build pipeline. - Fastify & WebSocket session relay server in
apps/server. - Gemini CLI adapter stub and basic terminal streaming in
@collagility/stream.