git404hub

what is opencode-zellij-indicator fr?

aidan-gallagher/opencode-zellij-indicator — explained in plain English

Analysis updated 2026-05-18

16TypeScriptAudience · developer

tl;dr

A plugin that adds status icons, a stopwatch, and sound alerts to Zellij tab names so you can instantly see which of your OpenCode AI coding sessions needs attention.

vibe map

mindmap
  root((opencode-zellij-indicator))
    What it does
      Tab status icons
      Session stopwatch
      Sound alerts
    Tech stack
      TypeScript
      OpenCode
      Zellij
    Use cases
      Multi session tracking
      Attention alerts
      Progress timing
    Audience
      Developers using OpenCode

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

See at a glance which of several OpenCode sessions in Zellij tabs is busy, blocked, or finished.

VIBE 2

Get an audio alert when a background OpenCode session finishes or needs a permission approval.

VIBE 3

Track how long a running OpenCode session has taken using the built in stopwatch.

VIBE 4

Run many parallel AI coding sessions in Zellij without losing track of which tab needs you.

what's the stack?

TypeScriptOpenCodeZellij

how it stacks up fr

aidan-gallagher/opencode-zellij-indicatorachrefelouafi/basicproceduralbuildingacoyfellow/tuiport
Stars161616
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderatemoderate
Complexity3/54/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

in plain english

This is a small plugin that solves a specific annoyance for people who run several OpenCode AI coding sessions at once inside Zellij, a terminal workspace tool with tabs. Normally every tab running OpenCode looks the same, so there is no way to tell at a glance which session is still working, which one is stuck waiting on you to approve something, and which one already finished. The plugin fixes this by adding a small status icon to each Zellij tab name. An hourglass means OpenCode is still busy and can be ignored for now. A question mark means it is blocked on a permission prompt or a question and needs your attention. A bell means it finished while you were not looking and the result has not been checked yet. A checkmark means it finished and you have already seen it. The plugin also reuses the session title that OpenCode automatically generates as the tab's name, and that title can be changed with OpenCode's built in rename command. Two extra features are included. A stopwatch shows how many minutes a session has been running once it passes a minute, and can be turned off with an environment variable. A sound notification plays when a background tab finishes or needs attention, which can also be disabled or replaced with a custom sound command through environment variables. To use it, you need Zellij version 0.44.0 or newer and OpenCode installed, then add the plugin's name to the plugin list in your opencode.json configuration file. The plugin only does anything while running inside Zellij, so it is safe to leave enabled even when OpenCode is run elsewhere.

prompts (copy fr)

prompt 1
Add opencode-zellij-indicator to my opencode.json plugin list and explain what each status icon means.
prompt 2
How do I disable the stopwatch and sound notification in this Zellij indicator plugin?
prompt 3
Set a custom sound command for this plugin using the OPENCODE_ZELLIJ_SOUND_CMD environment variable.
prompt 4
Explain how this plugin decides whether a tab shows the working, needs you, or done icon.

Frequently asked questions

what is opencode-zellij-indicator fr?

A plugin that adds status icons, a stopwatch, and sound alerts to Zellij tab names so you can instantly see which of your OpenCode AI coding sessions needs attention.

What language is opencode-zellij-indicator written in?

Mainly TypeScript. The stack also includes TypeScript, OpenCode, Zellij.

Who is opencode-zellij-indicator for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.