Quick Start

1. Start a Copilot Session

Open your terminal and run any Copilot CLI command:

copilot "Refactor this function to use async/await"

2. Watch the Notch

Copilot Island automatically detects the new session. You'll see:

• A pulsing dot in the notch indicating an active session
• The left peek icon animates to show the agent's current state (working, complete, error)

3. Explore the Panel

Click the notch to expand the Copilot Island panel:

Section	What you see
🔵 Sessions	All active and recent Copilot CLI sessions
💬 Chat	Full conversation history with Markdown rendering
⚡ Tools	Real-time tool execution feed (file writes, shell commands)
⚙️ Settings	Sound, About, and check-for-updates

4. Session Notifications

When the agent finishes a task:

• 🏆 A trophy animation flashes in the left notch peek for 3 seconds
• 🎵 A completion chime plays (can be disabled in Settings)

If the agent is aborted or encounters an error:

• ❌ A failure animation flashes for 3 seconds
• 🔔 A failure sound plays

5. Keyboard Shortcuts

Shortcut	Action
Click notch	Toggle expand/collapse
Hover notch	Preview active session