> ## Documentation Index
> Fetch the complete documentation index at: https://docs.voido.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Install Void Island for AI sessions and focus in the notch

> Void Island is a separate macOS app shipped with Voido that sits in the notch or menu bar to show AI coding sessions, focus, your schedule and journal. Learn how to install, connect and update it.

Void Island is a separate macOS app that ships with Voido and sits at the top of your screen, in the notch or the menu bar. Use it to watch running AI coding sessions and answer their approvals, start focus, check your schedule, or add a line to today's daily note. Void Island is macOS only.

## Install

The first time you open Voido, it copies its bundled Void Island into the Applications folder and opens it in the background; nothing is downloaded.

If you delete Void Island, Voido won't put it back. To reinstall it:

**1. Open Island settings**

In Voido, open Settings → **Island**. The status shows **Not installed**, **Installed, not running**, or that an update is available.

**2. Install and open**

Click **Install Void Island**. Voido copies its bundled Void Island into the Applications folder and opens it.

**3. Finish connecting**

Once connected, the card is replaced by Void Island's full settings.

To start Void Island at login, add it under macOS System Settings → General → Login Items.

## Tabs

Under **Position**, choose **Notch** or **Menu Bar**. Void Island has these tabs:

* **Need Voido**: Map, Focus, Journal and Calendar read and write your tasks and notes, so Voido must be running.
* **Work on their own**: AI, Git, Menu Bar, Cat and others.

**Journal** adds a timestamped line to today's daily note.

In **Focus**, pick one of today's tasks or start a free session; a new thing you write down there is added to your tasks.

## Connect AI coding agents

The AI tab shows Claude Code and Codex sessions, plus Gemini CLI, Cursor and OpenCode if they're installed. Chats with the assistant inside Voido appear as **Void Assistant**.

**1. Connect hooks**

Under **AI coding agent hooks**, click **Connect**. Void Island backs up the original configuration files first.

**2. Trust Codex hooks**

For Codex, also choose **Trust Hooks** in Codex once.

**3. Approve from the notch**

When an agent asks for approval, asks a question or presents a plan, handle it on Void Island: ⌘Y allows and ⌘N denies.

**Disconnect** removes only the hooks Void Island added. You can also turn on a notification when a session finishes, show usage limits, and keep your Mac awake while AI runs.

## Updates

Void Island has no updater of its own and updates with Voido. When an updated Voido starts and Void Island isn't running, Voido replaces it with the new version. If Void Island is running, quit it first, then click **Update Void Island** in Settings → **Island**.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.