官方说明开源项目7 天前
tim0-12432/opencode-streamdeck-traffic-lights
OpenCode and StreamDeck plugins for displaying traffic lights for your AI agent sessions.
在 GitHub 查看 ↗直链 · 无中转页
- ★ 数取值
- 0 ★ · tim0-12432/opencode-streamdeck-traffic-lights · 取自该仓库的 GitHub 页面 · （2026-10-16 20:00:20 核对）
- 来源明细
- 从该仓库的 GitHub 页面直接读取 · 条目类型：开源项目
- 收录与活跃
- 收录于 2026-10-10 · 最近见到 2026-10-10 · 共见到 1 次 · 被 1 个来源列出
- 评分构成
- 综合分 103 · 1 个来源 · repo
常见问题（答案都来自我们的记录）
怎么安装？
我们【没有】从该仓库取到安装命令（我们的 install 覆盖率只有约 4%）。请看它的 README 或 releases 页。
它适合谁 / 用来做什么？
我们把它归在这些标签下: 开源项目。标签来自条目自身，不是我们强加的分类。
谁维护它、还在更新吗？
仓库
tim0-12432/opencode-streamdeck-traffic-lights；我们收录于 2026-10-10；最近见到 2026-10-10。这里没有"官方认证"或"质量评级"——我们只记录来源与时间。第三方质量标记
OpenCode StreamDeck Traffic Lights
以下摘录自该仓库的 README（片段） · 在 GitHub 读完整 README →
See your OpenCode agent's status on a Stream Deck key, so you know from across the room whether it needs you.
What the colours mean
| | State | Meaning |
| --- | --- | --- |
| 🟢 | **Green** | At rest: idle, or waiting for you to answer a permission prompt. |
| 🟡 | **Yellow** | Thinking: busy, but no tool is running and no text is being written. |
| 🔴 | **Red** | Working: a tool is running or text is streaming. Also shown for **1 minute after an error**. |
If several sessions run in one OpenCode process, the key shows the most urgent one.
Quick start
**1. Install the Stream Deck plugin.**
Download the .streamDeckPlugin file from the latest release and double-click it.
**2. Add a key.**
Drag the **OpenCode Status** action onto any key in the Stream Deck app.
**3. Enable the OpenCode plugin.**
Add it to ~/.config/opencode/opencode.json, or to a project-level config:
Start OpenCode. The key should turn green.
Multiple agents
Each key watches one **instance** number, which defaults to 1. To track several agents, give each OpenCode process its own number:
Then set the same number in the key's **Instance** field. Up to 32 instances are supported.
Requirements
- OpenCode with plugin support (tested with 1.18.32)
- Stream Deck app 7.1 or newer
- Windows 10+ or macOS 12+
Troubleshooting
**The key never lights up.**
Usually the instance numbers don't match. Check that OPENCODE_STREAMDECK_INSTANCE equals the key's **Instance** setting. To confirm that OpenCode loaded the plugin, look in its log for:
**The key is stuck on a colour.**
If OpenCode dies, the key resets to green within about 7 seconds. If it doesn't, check the plugin logs in the .sdPlugin/logs/ folder.
**Port 8765 is already in use.**
Another copy of the plugin is running, often a leftover pnpm watch. Close it and restart the Stream Deck app.
**Upgrading from com.tim0-12432.opencode-traffic-lights?**
The plugin ID changed, so existing keys need to be re-added and their **Instance** set again.
How it works
The OpenCode plugin sends its current state to a small local server inside the Stream Deck plugin every 2 seconds. That server listens on 127.0.0.1 only, so it is never reachable from the network.
For the wire contract, timing rules, and recovery behaviour, see ARCHITECTURE.md.
Development
Prerequisites: Node.js 24 and pnpm 11.
What the colours mean
| | State | Meaning |
| --- | --- | --- |
| 🟢 | **Green** | At rest: idle, or waiting for you to answer a permission prompt. |
| 🟡 | **Yellow** | Thinking: busy, but no tool is running and no text is being written. |
| 🔴 | **Red** | Working: a tool is running or text is streaming. Also shown for **1 minute after an error**. |
If several sessions run in one OpenCode process, the key shows the most urgent one.
Quick start
**1. Install the Stream Deck plugin.**
Download the .streamDeckPlugin file from the latest release and double-click it.
**2. Add a key.**
Drag the **OpenCode Status** action onto any key in the Stream Deck app.
**3. Enable the OpenCode plugin.**
Add it to ~/.config/opencode/opencode.json, or to a project-level config:
Start OpenCode. The key should turn green.
Multiple agents
Each key watches one **instance** number, which defaults to 1. To track several agents, give each OpenCode process its own number:
Then set the same number in the key's **Instance** field. Up to 32 instances are supported.
Requirements
- OpenCode with plugin support (tested with 1.18.32)
- Stream Deck app 7.1 or newer
- Windows 10+ or macOS 12+
Troubleshooting
**The key never lights up.**
Usually the instance numbers don't match. Check that OPENCODE_STREAMDECK_INSTANCE equals the key's **Instance** setting. To confirm that OpenCode loaded the plugin, look in its log for:
**The key is stuck on a colour.**
If OpenCode dies, the key resets to green within about 7 seconds. If it doesn't, check the plugin logs in the .sdPlugin/logs/ folder.
**Port 8765 is already in use.**
Another copy of the plugin is running, often a leftover pnpm watch. Close it and restart the Stream Deck app.
**Upgrading from com.tim0-12432.opencode-traffic-lights?**
The plugin ID changed, so existing keys need to be re-added and their **Instance** set again.
How it works
The OpenCode plugin sends its current state to a small local server inside the Stream Deck plugin every 2 seconds. That server listens on 127.0.0.1 only, so it is never reachable from the network.
For the wire contract, timing rules, and recovery behaviour, see ARCHITECTURE.md.
Development
Prerequisites: Node.js 24 and pnpm 11.
- 来源
- github · https://github.com/tim0-12432/opencode-streamdeck-traffic-lights
- 按领域浏览
- 开源项目
- 收录于
- 7 天前
更多开源项目
所属领域与标签
每个标签都能点进去看同类的全部条目。数字是当前库里的真实条数。