Skip to main content
toolsSource-backedReview first Safety Privacy
Agent Island logo

Agent Island

Open-source status companion for Claude Code and Codex with live local session state, your-turn alerts, usage views, and native macOS and Windows applications.

by Tristan Tang · submitted by tristan666666·added 2026-07-15·
HarnessCodexCLI
Review first review before installing

Open the source and read safety notes before installing.

Citation facts

Source-backed facts for citing this resource, derived directly from the registry — also available as plain text for AI assistants.

Source URLs
https://github.com/tristan666666/agent-island#readme, https://github.com/tristan666666/agent-island, https://agent-island.dev
Brand
Agent Island
Brand domain
agent-island.dev
Brand asset source
brandfetch
Safety notes
Agent Island reads local Claude Code and Codex session files to determine session state; review the requested filesystem access before use., The macOS release is ad-hoc signed rather than Apple-notarized, so first launch requires right-clicking the app and choosing Open., Windows packages are distributed through GitHub Releases, Scoop, and winget; verify the release source before installation.
Privacy notes
Session monitoring is local and the project states that the app has no Agent Island account and no product telemetry., Usage views may call provider usage APIs with existing local credentials; those requests remain subject to the provider's privacy terms., Local transcript files and provider credentials can contain sensitive data and should not be included in public screenshots, issues, or logs.
Author
Tristan Tang
Submitted by
tristan666666
Claim status
unclaimed
Last verified
2026-07-15

Decision playbook

Review trust signals before you adopt

Signals are present but mixed. Use the checklist below to confirm the source and operational safety for your environment.

Compare context
Selected

0

Current score

78

Baseline

Delta

No baseline selected

No major trust-signal divergence detected in the current selection.

Source and provenance checks

Complete

Confirm ownership and provenance before trusting install instructions.

  • Source link availableRequired

    Open the canonical repository and verify ownership.

    Done
  • Source provenance statusRequired

    Marked as source-backed.

    Done
  • Metadata reviewed

    Registry metadata indicates a reviewed listing.

    Done

Safety and privacy checks

Complete

Validate risk disclosures before installation or API wiring.

  • Safety notes presentRequired

    Review the listed safety guidance before running commands.

    Done
  • Privacy notes presentRequired

    Review data handling notes before connecting accounts or secrets.

    Done
  • Trust level risk gateRequired

    Trust level does not block evaluation.

    Done

Package and install checks

Needs review

Check package metadata and artifact integrity signals.

  • Install payload available

    Install or copy payload is available for review.

    Done
  • Package verification flag

    No package verification flag provided.

    Pending
  • Checksum metadata

    No checksum provided for downloaded artifact.

    Pending

Compare-driven decision checks

Needs review

Use compare context to validate trade-offs before adoption.

  • Compare tray has multiple entries

    Add at least one more entry to compare trust differences.

    Pending
  • Baseline comparison available

    No baseline peer selected yet.

    Pending
  • Diverging trust signals identified

    No major trust-signal divergence found.

    Pending

Setup at a glance

CLI install

Copy-ready — paste the snippet to get started.

5 minutes

Install command

Provided

Config snippet

Not provided

Copy snippet

Provided

Prerequisites

2 to clear

Platforms

2 listed

Install type

CLI install

Adoption plan

Balanced adoption plan

Current risk score 16/100. Use staged verification before broader rollout.

Risk 16

Pre-adoption checks

Validate source and review signals before any execution.

  • Confirm source provenanceRequired

    Source URL/provenance metadata is present.

    Done
  • Confirm metadata review state

    Listing has review metadata.

    Done
  • Verify install payload

    Install/config payload exists and can be inspected.

    Done

Security checks

Confirm safety, privacy, and package integrity signals.

  • Review safety notesRequired

    Safety notes are present.

    Done
  • Review privacy notesRequired

    Privacy notes are present.

    Done
  • Verify package integrity metadata

    No package verification/checksum metadata.

    Pending

Rollout

Adopt in controlled steps based on the selected plan.

  • Run in isolated sandbox firstRequired

    Use a constrained sandbox and observe behavior across multiple tasks.

    Pending
  • Roll out graduallyRequired

    Roll out to a small cohort before wider usage.

    Pending
  • Set monitoring and fallback

    Define rollback path and monitor errors after adoption.

    Pending

Evidence readiness

Evidence readiness matrix · balanced

Required evidence gates are covered (5/6 signals complete).

Risk 15

Source provenance

Present

Source repository/provenance is listed.

Required in this preset

Metadata review

Present

Review metadata is present.

Required in this preset

Safety notes

Present

Safety notes are present.

Required in this preset

Privacy notes

Present

Privacy notes are present.

Optional in this preset

Package integrity

Missing

Package integrity metadata is missing.

Optional in this preset

Install payload

Present

Install payload is available.

Required in this preset

Required evidence gates are covered for this preset.

Decision timeline

Decision timeline · balanced

5/6 steps complete with no blocking gaps for this preset.

Risk 14

triage

Confirm source provenanceRequired

Source/provenance metadata is available.

Done

triage

Check metadata review statusRequired

Review metadata is available.

Done

verify

Review safety notesRequired

Safety notes are available.

Done

verify

Review privacy notes

Privacy notes are available.

Done

verify

Validate package integrity metadata

Package integrity metadata is missing.

Pending

rollout

Verify install payload and commandsRequired

Install payload is available.

Done

No required blockers for this timeline preset.

Prerequisite readiness

Prerequisite readiness

2 prerequisites to line up before setup.

0/2 ready
Install & runtime1General15 minutes

Safety & privacy surface

Safety & privacy surface

3 safety and 3 privacy notes across 3 risk areas. Review closely: credentials & tokens.

3 areas
  • SafetyCredentials & tokensAgent Island reads local Claude Code and Codex session files to determine session state; review the requested filesystem access before use.
  • SafetyGeneralThe macOS release is ad-hoc signed rather than Apple-notarized, so first launch requires right-clicking the app and choosing Open.
  • SafetyExecution & processesWindows packages are distributed through GitHub Releases, Scoop, and winget; verify the release source before installation.
  • PrivacyCredentials & tokensSession monitoring is local and the project states that the app has no Agent Island account and no product telemetry.
  • PrivacyCredentials & tokensUsage views may call provider usage APIs with existing local credentials; those requests remain subject to the provider's privacy terms.
  • PrivacyCredentials & tokensLocal transcript files and provider credentials can contain sensitive data and should not be included in public screenshots, issues, or logs.

Disclosure: claimed

Safety notes

  • Agent Island reads local Claude Code and Codex session files to determine session state; review the requested filesystem access before use.
  • The macOS release is ad-hoc signed rather than Apple-notarized, so first launch requires right-clicking the app and choosing Open.
  • Windows packages are distributed through GitHub Releases, Scoop, and winget; verify the release source before installation.

Privacy notes

  • Session monitoring is local and the project states that the app has no Agent Island account and no product telemetry.
  • Usage views may call provider usage APIs with existing local credentials; those requests remain subject to the provider's privacy terms.
  • Local transcript files and provider credentials can contain sensitive data and should not be included in public screenshots, issues, or logs.

Prerequisites

  • macOS 13 or later, or Windows 10 or later.
  • A local Claude Code or Codex installation with session data available to the current user.

Schema details

Install type
cli
Troubleshooting
No
Source repository stats
Scope
Source repo
Collection metadata
Estimated setup
5 minutes
Difficulty
beginner
Tool listing metadata
Pricing
open-source
Disclosure
claimed
Application category
DeveloperApplication
Operating system
macOS 13+, Windows 10+
Full copyable content
brew install tristan666666/tap/agentisland

About this resource

Overview

Agent Island is a native desktop companion for developers who run Claude Code or Codex in background terminals and need a quick signal when a session is working, waiting, or needs attention. It presents current session state in a macOS top bar or Windows top bar and floating widget, then surfaces a system notification, sound, and alarm window when it is the user's turn.

The project is MIT licensed and ships separate native implementations for macOS and Windows. It is a monitoring companion rather than a coding agent: it does not replace Claude Code or Codex and does not submit prompts on the user's behalf.

Install

On macOS, install through the project's Homebrew tap:

brew install tristan666666/tap/agentisland

On Windows, install through winget:

winget install TristanTang.AgentIsland

The latest GitHub release also provides a macOS DMG and a Windows x64 ZIP.

Core Capabilities

  • Live local session state for Claude Code and Codex.
  • Your-turn notifications when a background session needs attention.
  • Native macOS and Windows interfaces without an Electron runtime.
  • Usage, cost, reset, and weekly report views where provider data is available.
  • English and Simplified Chinese interfaces.
  • Local-first monitoring with no Agent Island account or product telemetry.

Safety and Privacy

Agent Island determines status by reading supported local session files, so its filesystem access should be treated like access granted to any developer tool that reads terminal or agent history. Keep private transcripts, screenshots, and local credentials out of public bug reports.

The project states that monitoring remains local and that the app has no product telemetry. Usage views can make requests to Claude or Codex provider APIs with credentials already stored on the machine, so provider-side handling still follows those services' terms.

Disclosure

Submitted by the Agent Island maintainer. No paid placement or affiliate link.

Source citations

Add this badge to your README

Show that Agent Island is listed on HeyClaude. Paste this Markdown into your README — it renders the badge and links back to this page.

Listed on HeyClaude
[![Listed on HeyClaude](https://heyclau.de/badge/tools/agent-island.svg)](https://heyclau.de/entry/tools/agent-island)

How it compares

Agent Island side by side with 3 alternatives on trust, install, platform support, and disclosed safety notes — all from reviewed registry metadata.

1 trust signal differ across this comparison (Submitter).

Next steps differ across entries — use the actions in the table below to copy install commands and source links per resource.

Field

Open-source status companion for Claude Code and Codex with live local session state, your-turn alerts, usage views, and native macOS and Windows applications.

Open dossier

Open-source project behind CodeLayer, an IDE for orchestrating AI coding agents built on Claude Code, with keyboard-first workflows, team context engineering, and parallel Claude Code sessions across worktrees and cloud workers.

Open dossier

MIT-licensed infrastructure for computer-use agents: background desktop drivers, MCP server support, Python SDKs, local/cloud sandboxes, macOS, Windows, Linux, Android, Cua Bench, GUI automation skills, and Lume virtualization for agents that see, click, type, and verify real desktops.

Open dossier

Lightweight, open-source coding agent from OpenAI that runs in your terminal, edits and runs code locally with configurable sandbox and approval modes, and authenticates with a ChatGPT plan or API key.

Open dossier
Next stepsDiffers
Trust
Review statusReviewedMaintainer reviewedReviewedMaintainer reviewedReviewedMaintainer reviewedReviewedMaintainer reviewed
Package trustPackage not verifiedPackage not verifiedPackage not verifiedPackage not verified
Source provenanceSource-backedSource-backedSource-backedSource-backed
SubmitterDifferstristan666666JPette1783JPette1783
Install riskReview firstReview firstReview firstReview first
Notes Safety Privacy Safety Privacy Safety Privacy Safety Privacy
BrandAgent Island logoAgent IslandHumanLayer logoHumanLayerCua Computer-Use Agents logoCua Computer-Use AgentsOpenAI logoOpenAI
Categorytoolstoolstoolstools
Sourcesource-backedsource-backedsource-backedsource-backed
AuthorTristan TangHumanLayerTryCuaOpenAI
Added2026-07-152026-06-052026-06-182026-06-05
Platforms
CodexCLI
CLI
CLI
CLI
Source repo
Safety notesAgent Island reads local Claude Code and Codex session files to determine session state; review the requested filesystem access before use. The macOS release is ad-hoc signed rather than Apple-notarized, so first launch requires right-clicking the app and choosing Open. Windows packages are distributed through GitHub Releases, Scoop, and winget; verify the release source before installation.CodeLayer orchestrates AI coding agents that edit files and run commands in your repositories, so it inherits the execution risks of the underlying Claude Code agent. MultiClaude runs multiple Claude Code sessions in parallel across git worktrees; review changes per worktree before merging to avoid conflicting or unreviewed edits. Remote cloud workers can run agent sessions on external infrastructure; understand where code executes before enabling them. Scaling agent workflows to a whole team increases the blast radius of automated edits, so keep human review and branch protections in place.Cua can give agents eyes and hands on a computer: screenshots, clicks, typing, dragging, shell commands, window control, file paths, and desktop automation. Treat it as high-impact automation. The README documents remote shell and PowerShell installer commands for Cua Driver and Lume. Review script contents, pin versions where possible, and avoid blind execution on sensitive machines. The GUI automation skill includes form fuzzing examples and shell/file actions; use only on authorized apps, test environments, or isolated sandboxes. Host-machine mode and background desktop control can interact with real apps without stealing focus. Keep host consent, allowlists, window targeting, and stop controls explicit. Cua Bench, Cua sandboxes, Lume, Docker, QEMU, cloud VMs, Windows sandbox, Android images, and BYOI environments need resource limits, cleanup, network policy, and credential isolation. Optional third-party components have separate license and safety implications; the README calls out Kasm, OmniParser, and optional `cua-agent[omni]` dependencies.Codex CLI runs as a local agent that can edit files and execute commands on your machine. It supports configurable sandbox and approval modes; keep approvals enabled and review proposed actions before allowing them. Lowering approval or sandbox restrictions lets the agent act more autonomously, increasing the risk of unintended changes. Review generated code and commands before running them against important repositories or systems.
Privacy notesSession monitoring is local and the project states that the app has no Agent Island account and no product telemetry. Usage views may call provider usage APIs with existing local credentials; those requests remain subject to the provider's privacy terms. Local transcript files and provider credentials can contain sensitive data and should not be included in public screenshots, issues, or logs.Because it builds on Claude Code, repository code and context are sent to Anthropic's API to power the agent. Remote cloud workers process your code and context on external infrastructure; review the provider's terms before sending private code. Any API keys or credentials used by Claude Code and CodeLayer should be stored as secrets, not committed to source control. Team and context-engineering features can share prompts, context, and workflow data across collaborators, so avoid placing secrets in shared context.Computer-use sessions can capture screenshots, typed text, window titles, app contents, browser pages, files, clipboard-like content, shell output, paths, downloads, and user workflows. Cua trajectories are recorded under `~/.cua/trajectories/...`; sharing trajectories can upload or expose screenshots, actions, commands, and replayable workflow details. Cloud sandboxes, Cua cloud, E2B-like backends, Docker registries, Lume images, MCP clients, model providers, and AI annotation features may process or store prompts, screenshots, tool actions, and environment metadata. Do not use host or cloud computer-control flows on confidential documents, customer systems, authenticated browser sessions, secrets, payments, destructive admin panels, or regulated data unless policy explicitly allows it.Code and prompts are sent to OpenAI to power the agent under your ChatGPT plan or API key. Data handling follows OpenAI's policies for the plan or API you authenticate with; review them before processing sensitive code. API keys and account credentials should be stored securely and never committed to source control.
Prerequisites
  • macOS 13 or later, or Windows 10 or later.
  • A local Claude Code or Codex installation with session data available to the current user.
  • Claude Code, since CodeLayer is built on top of it and orchestrates Claude Code sessions.
  • An Anthropic account or API access for the underlying Claude Code agent.
  • A recent CodeLayer build from the project's GitHub releases or the waitlist for early access.
  • Git, since parallel-session workflows rely on worktrees.
  • Python 3.12 or newer for the `cua` meta-package, with package-specific Python requirements checked for `cua-agent`, `cua-computer`, `cua-computer-server`, `cua-mcp-server`, and related packages.
  • A target runtime choice: local desktop, cloud Cua sandbox, Docker/container, QEMU VM, Lume macOS VM, Windows sandbox, Android, or bring-your-own image.
  • Explicit approval and scoping before giving an agent host desktop control, shell access, file access, screenshots, keyboard input, mouse input, or host-machine access.
  • Review of the Cua Driver install scripts before running curl-to-shell or PowerShell bootstrap commands from the README.
  • A ChatGPT plan (Plus, Pro, Business, Edu, or Enterprise) for plan-based sign-in, or an OpenAI API key.
  • Node.js and npm for the npm install, or Homebrew for the cask install.
  • A terminal on macOS, Linux, or Windows.
Install
brew install tristan666666/tap/agentisland
pip install cua
Config
Citations
ClaimUnclaimedUnclaimedUnclaimedUnclaimed
Open 4 picks in the interactive comparison tool

Related guides

Signals

Loading live community signals…

More like this, weekly

A short, calm digest of reviewed Claude resources. Unsubscribe any time.