Repolode
Submit
TheKeyblader

TheKeyblader/opencode-eye

An animated eye plugin for OpenCode Desktop that visually reflects what the AI agent is doing in each session.

View on GitHub
Stars
2
Forks
0
Open issues
0
Last commit
8 days ago

What is it?

opencode-eye is a community plugin for OpenCode Desktop that adds an animated eye to a tab in the session's side panel. The eye changes its expression to match the agent's activity: it shows a thought bubble while reasoning, a magnifier while reading files, a pencil while editing, and a terminal gaze while running shell commands.

The eye covers 18 states plus three modifiers. It also reacts to approval requests, context compaction, failed tool calls, successful runs and long-running tools, so a user can glance at the panel to see what the agent is doing without reading the log. Clicking the eye opens a card with the current tool, how long the state has lasted and recent transitions.

The plugin requires OpenCode Desktop 2.2.0 or later, since it uses the experimental GUI plugin API. It is installed by adding the package name to the plugins list in the OpenCode config, and it can also be built from a clone with Bun. Size, colors, reduced motion and MCP server icons are configurable in settings, and the interface supports English and French.

Key features

  • 01Shows 18 distinct eye states tied to agent activity, such as thinking, reading, writing and waiting for approval.
  • 02Adds three modifiers for long-running tools, idle periods and a nearly full context window.
  • 03Opens a details card with the current tool, state duration and recent transitions.
  • 04Offers settings for size, colors, reduced motion and per-MCP-server icons.
  • 05Supports English and French, following the app's language.

Use cases

  • Keeping an eye on a long agent run without reading the full transcript.
  • Spotting when the agent is waiting for your approval or a question.
  • Noticing tool failures or a context window that is nearly full during a session.

Quick start

  1. 1

    Add the plugin to your OpenCode config

  2. 2

    Restart OpenCode Desktop

Things to know

  • Requires OpenCode Desktop 2.2.0 or later, which uses an experimental GUI plugin API.
  • Not affiliated with the OpenCode team; it is a community plugin.

In collections

Open-source AI agent frameworks & apps

Topics

#opencode#ai-agent#desktop-plugin#animation#typescript#solid-js#opencode-plugin

FAQ

What is opencode-eye?
An animated eye plugin for OpenCode Desktop that visually reflects what the AI agent is doing in each session. opencode-eye is a community plugin for OpenCode Desktop that adds an animated eye to a tab in the session's side panel. The eye changes its expression to match the agent's activity: it shows a thought bubble while reasoning, a magnifier while reading files, a pencil while editing, and a terminal gaze while running shell commands.
Is opencode-eye free to use? What license does it have?
opencode-eye is open source under the MIT license. Check the license terms before using it in commercial products.
Is opencode-eye still maintained?
Actively maintained. The last commit to opencode-eye was on Oct 30, 2026.
What can I use opencode-eye for?
Keeping an eye on a long agent run without reading the full transcript. Spotting when the agent is waiting for your approval or a question. Noticing tool failures or a context window that is nearly full during a session.
How do I install opencode-eye?
Add the plugin to your OpenCode config Restart OpenCode Desktop
Where can I get opencode-eye?
The source code and installation instructions are on GitHub: https://github.com/TheKeyblader/opencode-eye

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects