wxtsky/CodeIsland
52.9
Adequate · 15 November 2026
86.6k
lines of production code
Swift
primary language
5
measurements over time
What this system is
CodeIsland is a cross-platform desktop application that monitors and manages AI coding agent sessions across various IDEs and command-line tools. It provides a unified interface for tracking task progress, handling permission approvals, and receiving push notifications, while integrating with companion devices like the Buddy hardware pet and mobile apps for status updates and remote control. The system supports multiple operating systems, including macOS, Windows, iOS, and Wear OS, ensuring consistent agent interaction and security across different environments.
Features
Automated macOS build, signing, and Sparkle-based auto-update pipeline
The scripts directory now includes a comprehensive build and release workflow for macOS. The new build-dmg.sh script assembles universal or arm64 app bundles, embeds the Sparkle framework for in-app updates, and handles Developer ID code signing and notarization. Supporting scripts manage the update process (update-appcast.sh generates signed appcast entries using EdDSA keys), while dev-hot-restart.sh provides a watch-and-restart loop for local development. Additionally, a suite of smoke and regression test scripts (smoke-companion.sh, check-companion-ui-regressions.sh, etc.) validates the companion app UI and protocol across iOS and watchOS simulators, and extract-changelog.sh automates release note extraction.
scripts · high confidence
Initial Windows port of CodeIsland core logic and tool hooks
This change introduces the foundational C\#/.NET 8 implementation for the Windows version of CodeIsland. It adds the core domain models (AgentEvent, SessionStateMachine) and a protocol serializer to manage AI agent sessions and events. It also includes the \codeisland-bridge.exe\ IPC service (using Windows Named Pipes) and a comprehensive hook management system that detects, installs, and uninstalls event hooks for supported AI coding tools like Claude, Codex, Gemini, and Cursor. Additionally, it provides the initial Bluetooth protocol definitions for ESP32 Buddy hardware integration.
(repo-wide) · high confidence
Introduce Wear OS companion app for Buddy Watch approval previews and alerts
The android-watch/app module adds a Wear OS companion application that mirrors the CodeIsland Buddy protocol via BLE, enabling users to view mascot status, agent activity, tool names, brightness, and orientation on their watch. It introduces specific UI and interaction capabilities for handling agent requests: users can now approve, deny, or skip current permissions and questions directly from the watch interface, with corresponding visual alerts and animations in the mascot view. The app also supports message previews, demo mode toggling, and adapts to both square and round watch screens.
android-watch, app · high confidence
New core modules for agent task tracking, AI companion payloads, and configuration resolution
This update introduces several new foundational components in CodeIslandCore. AgentTaskList and AgentTaskParsing provide a unified system for tracking and parsing agent task checklists (e.g., from Claude, Codex, and Cursor), handling status updates, merges, and snapshots. AiWorkWatchClient adds support for connecting to the Agentix daemon to monitor AiWork GUI/TUI sessions. AntigravityHookContract defines the logic for handling Google Antigravity's PreToolUse hooks. AppDistribution adds logic for handling app distribution, including release notes links and detecting read-only installation locations. AppleCompanionPayload defines the data structures for communicating with the Apple Companion app. ChatMessageTextFormatter improves markdown rendering, specifically handling fenced code blocks and inline spans. ClaudeConfigPaths provides a robust, memoized resolution chain for finding the Claude Code configuration directory, honoring environment variables, user preferences, and XDG-style paths. ClaudeQuota introduces structures and parsing logic for displaying Anthropic's usage quotas and limits.
Sources/CodeIslandCore · high confidence
New hardware companion device for displaying AI agent status animations
This change introduces the 'Buddy' hardware peripheral, an ESP32-C6-based desk pet that receives real-time AI Coding Agent status updates (idle, processing, waiting for approval/question) from the CodeIsland macOS application via Bluetooth Low Energy (BLE). The device features a 1.47-inch TFT screen that displays animated pixel mascots corresponding to the agent's state, with specific animations for sleep, work, alert, and question modes. The firmware includes a pairing protocol, demo mode for cycling through 16 different mascot designs, and remote control capabilities for screen brightness and orientation. Documentation is provided for hardware setup, Arduino IDE configuration, and rendering optimizations using off-screen double buffering to prevent screen tearing.
hardware · high confidence
New integration extensions for OpenCode, Pi, and OMP
Added new resource files that serve as integration extensions for the OpenCode, Pi, and Oh My Pi (OMP) coding agents. These extensions bridge the agents' lifecycle events and permission requests to the CodeIsland macOS app via Unix sockets, enabling users to manage agent sessions, approve dangerous commands, and answer questions directly from the CodeIsland interface. Also in this area: Fixes for session removal persistence, shortcut visibility, and mascot animation stability; Fixes for process discovery, session pairing, and companion security; Security and stability fixes for remote hooks and subagent sessions; Fix session title mapping and Hermes session lifecycle handling.
Sources/CodeIsland/Resources · high confidence
New task progress tracking and expanded AI agent integrations
Users can now see real-time agent task checklists on session cards, including a segmented progress bar, completion counts, and the current activity label, with an expandable list of individual items. This feature is supported by a new background transcript scan that backfills task history when a session attaches, ensuring progress is visible even for long-running sessions. Additionally, the app adds support for new AI sources: AiWork (Agentix) sessions are now discovered and monitored via a dedicated watcher, and the Codex Desktop app-server integration is enhanced with robust reconnection logic and session preservation to handle app restarts gracefully.
Sources/CodeIsland · high confidence
Behavioural changes
CodeIsland v1.0.35 release notes and auto-update configuration
The changelog now documents the v1.0.35 release, introducing session task progress bars, session recaps, Markdown rendering for replies, push notifications to services like Slack and Telegram, follow-up reminders, Claude Desktop Cowork support, multi-account configuration, and refined sound and focus behaviors. The app's Info.plist has been updated to version 1.0.35 and configured for Sparkle-based auto-updates with ed25519 signature verification, while the appcast.xml has been populated with release entries from v1.0.22 through v1.0.35. Also in this area: CodeIsland v1.0.41 release; iPhone Buddy can't answer requests until it pairs; Release v1.0.39 ships with corrected binaries and improved remote session handling; Codex Desktop threads reappear on newer ChatGPT builds; Release v1.0.37 with improved Codex conversation card handling; and 1 more.
(repo-wide) · high confidence
Discovery logic refactored into dedicated per-source modules
The discovery subsystem has been restructured to improve maintainability and isolation. Agent process detection logic has been extracted into a new \AgentProcessFinder\ module, which now handles process table scans and bundle-path matching for all supported IDEs and CLIs. Additionally, discovery logic for specific agents has been moved into dedicated source files (e.g., \ClaudeDiscovery\, \CursorDiscovery\, \CopilotDiscovery\), separating the concerns of process finding, transcript reading, and session matching. This change also includes a fix to ensure that discovery scans correctly handle state transitions after a stop, preventing old scan handles from interfering with new ones. Also in this area: Fixes for process discovery, session pairing, and companion security.
Sources/CodeIsland/Discovery · high confidence
Improved process ancestry detection and robust hook payload normalization
The bridge now traces parent processes to infer the source of hook events when the --source argument is missing, ensuring accurate attribution for tools like Cursor and Grok. It also normalizes inconsistent JSON field names (e.g., camelCase vs. snake\_case) and environment variables from third-party CLIs like Google Antigravity and Grok, making session and event data reliable across different integrations. Additionally, socket connections now support configurable timeouts, and logging can be redirected via an environment variable to prevent test artifacts from polluting production logs.
Sources/CodeIslandBridge · high confidence
Fixes
Security and stability fixes for remote hooks and subagent sessions
This update addresses several security and behavioral issues in the CodeIsland resource scripts. It introduces socket ownership checks (using \lstat\) in the OpenClaw, OpenCode, and remote hook plugins to prevent other users on the same host from intercepting events or answering permission requests. It also fixes subagent session handling in the Oh My Pi and Pi extensions to ensure only the parent session's completion sound rings and that subagent payloads correctly identify their parent. Additionally, the remote hook now correctly identifies Cursor's Claude Code hooks as 'Cursor' instead of 'Claude', and the OpenCode plugin now sanitizes tab titles to prevent terminal escape sequence injection. Also in this area: New OpenClaw integration plugin for CodeIsland.
Sources/CodeIsland/Resources/codeisland-openclaw · high confidence
iOS companion app adds foreground reconnection and tolerant payload decoding
The new CodeIslandCompanion app now automatically reconnects to the Mac when the iPhone app returns to the foreground, preventing it from getting stuck in a "disconnected" state after being backgrounded. Additionally, the app uses tolerant decoding for session payloads, ensuring that unknown status values or missing fields from newer Mac versions do not cause crashes or decode failures.
ios · high confidence
Test coverage
Added test coverage for OMP Ask race settlement, AiWork daemon interactions, and session answer routing; Added test infrastructure to reset UserDefaults before test runs; Added tests for AttentionPolicy and Bridge golden fixtures; Expanded test coverage for CodeIslandCore.
Dependencies
Initial release of CodeIsland v1.0 with multi-platform support
This entry marks the initial release of CodeIsland v1.0, establishing the foundational build structure and dependencies for the application. The diff introduces Swift Package Manager dependencies for Sparkle (v2.9.1) to enable auto-update capabilities with ed25519 signature verification, and Yams (v5.4.0) for YAML processing. It also adds a Node.js bridge plugin for OpenClaw integration and sets up the Android Watch companion app (BuddyWatch) with Android SDK 34 and Kotlin 1.9.24. Furthermore, it defines the Windows desktop application structure using .NET 8.0, including core libraries, IPC, Bluetooth, and WPF/WinForms UI components.
(dependencies) · high confidence
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
How this codebase got here
Score
- CAI 55 → 53 (-2.2)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.4) — scores are not directly comparable.
Lenses
- Code Health 47 → 41 (-5.7)
- Architecture 98 → 98 (+0.2)
- Maturity 65 → 68 (+3.7)
- Readiness 53 → 53 (+0.0)
- Security 79 → 71 (-8.3)
- Performance 66 → 70 (+4.1)
Resolved (55)
- Duplicated block (10 lines × 2) (Sources/CodeIsland/AppState.swift)
- Duplicated block (10 lines × 2) (ios/CodeIslandCompanion/CodeIslandCompanion/CompanionConnection.swift)
- Duplicated block (10 lines × 2) (ios/CodeIslandCompanion/CodeIslandWatchApp/WatchContentView.swift)
- Duplicated block (10–12 lines × 3) (Sources/CodeIsland/RemoteInstaller.swift)
- Duplicated block (11 lines × 2) (Sources/CodeIslandCore/SessionSnapshot.swift)
- Duplicated block (11–12 lines × 2) (Sources/CodeIsland/DebugHarness.swift)
- Duplicated block (11–14 lines × 2) (Sources/CodeIsland/AppState.swift)
- Duplicated block (12 lines × 2) (Sources/CodeIslandCore/CoworkSession.swift)
- Duplicated block (13 lines × 2) (Sources/CodeIsland/TerminalActivator.swift)
- Duplicated block (14–15 lines × 2) (Sources/CodeIsland/ConfigInstaller.swift)
- Duplicated block (14–17 lines × 5) (Sources/CodeIslandCore/AppleCompanionPayload.swift)
- Duplicated block (15–16 lines × 2) (Sources/CodeIslandCore/HookIntake.swift)
- Duplicated block (17 lines × 2) (Sources/CodeIsland/AppState.swift)
- Duplicated block (4–21 lines × 4) (ios/CodeIslandCompanion/CodeIslandCompanion/CompanionConnection.swift)
- Duplicated block (5 lines × 13) (Sources/CodeIsland/BuddyView.swift)
- Duplicated block (5 lines × 2) (Sources/CodeIsland/DebugHarness.swift)
- Duplicated block (5 lines × 2) (Sources/CodeIsland/NotchPanelView.swift)
- Duplicated block (5 lines × 2) (Sources/CodeIslandCore/AppleCompanionPayload.swift)
- Duplicated block (5 lines × 2) (Sources/CodeIslandCore/HookIntake.swift)
- Duplicated block (5 lines × 2) (android-watch/app/src/main/java/com/codeisland/buddywatch/BuddyMascotView.kt)
- …and 35 more
New (153)
- Duplicated block (10 lines × 2) (ios/CodeIslandCompanion/CodeIslandCompanion/CompanionConnection.swift)
- Duplicated block (10–12 lines × 3) (Sources/CodeIsland/RemoteInstaller.swift)
- Duplicated block (11–14 lines × 2) (Sources/CodeIsland/AppState.swift)
- Duplicated block (13 lines × 2) (Sources/CodeIsland/AppState+TranscriptTailer.swift)
- Duplicated block (14 lines × 2) (Sources/CodeIslandCore/AppleCompanionPayload.swift)
- Duplicated block (15–16 lines × 2) (Sources/CodeIslandCore/HookIntake.swift)
- Duplicated block (17 lines × 2) (Sources/CodeIsland/AppState.swift)
- Duplicated block (21 lines × 2) (Sources/CodeIslandCore/SessionSnapshot.swift)
- Duplicated block (5 lines × 2) (Sources/CodeIsland/AiWorkView.swift)
- Duplicated block (5 lines × 2) (Sources/CodeIslandCore/AppleCompanionPayload.swift)
- Duplicated block (5 lines × 2) (android-watch/app/src/main/java/com/codeisland/buddywatch/BuddyMascotView.kt)
- Duplicated block (5 lines × 5) (Sources/CodeIsland/ConfigInstaller.swift)
- Duplicated block (6 lines × 2) (Sources/CodeIsland/AppState.swift)
- Duplicated block (6 lines × 2) (android-watch/app/src/main/java/com/codeisland/buddywatch/BuddyMascotView.kt)
- Duplicated block (6 lines × 4) (Sources/CodeIsland/ConfigInstaller.swift)
- Duplicated block (6 lines × 5) (android-watch/app/src/main/java/com/codeisland/buddywatch/BuddyMascotView.kt)
- Duplicated block (7 lines × 3) (android-watch/app/src/main/java/com/codeisland/buddywatch/BuddyMascotView.kt)
- Edited copies of one member (3 members, 10+ corresponding lines) (Sources/CodeIsland/Discovery/FlatStoreDiscovery.swift)
- Edited copies of one member (3 members, 12+ corresponding lines) (android-watch/app/src/main/java/com/codeisland/buddywatch/BuddyMascotView.kt)
- Edited copies of one member (3 members, 26+ corresponding lines) (Sources/CodeIsland/KiroView.swift)
- …and 133 more
Architecture
- Unchanged — 3 containers · 4 contexts · 2 edges
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
wxtsky/CodeIsland was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.
About this page
- The score is its most recent published measurement, taken on 15 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
- Measured at commit 03c77e9457f0adc56fa036caf4925e4a576b453b — the exact code this score is about.
- Scored under rubric-2026.11.4 — the same rubric and the same method as every other entry in this index.
- Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.65+preprod-3c33c1882dc1.