rohaquinlop

Omarchy Agent Collectors — AI skill for Claude Code

AI community

Omarchy shell plugin: extensible usage collectors for AI coding agents (Pi, OpenCode, and more) feeding the stock omarchy.agents panel.

How to install Omarchy Agent Collectors

This entry records only its repository, not the path inside it, so there is no exact command to give. Open rohaquinlop/omarchy-agent-collectors and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Omarchy Agent Collectors does

Omarchy shell plugin: extensible usage collectors for AI coding agents (Pi, OpenCode, and more) feeding the stock omarchy.agents panel.

Alternatives in AI

Codeburn — Free, local tool to track AI coding token usage and cost across 37 tools and agents (Claude Code, Cursor, Code 9.7k ★
CodeIsland — Real-time AI coding agent status panel in your MacBook notch — live status, approvals & replies for 13 AI tool 2.3k ★
Token Monitor — Local-first desktop widget for tracking token usage, costs, and limits across 32+ AI coding tools—including Cl 1.8k ★

README

omarchy-agent-collectors

Extensible usage collectors for AI coding agents on [Omarchy](https://omarchy.org).

The omarchy.agents panel showing Claude, OpenCode, and Pi tabs

One engine, many drop-in adapters. Writes stock-contract records into `~/.local/state/omarchy/agents/usage/`, where Omarchy's built-in `omarchy.agents` bar panel picks them up automatically — no UI code involved.

Out of the box: **Pi** (`~/.pi/agent/sessions`) and **OpenCode** (`~/.local/share/opencode/opencode.db`). Anything else is one manifest away.

Install

omarchy plugin add https://github.com/rohaquinlop/omarchy-agent-collectors.git --enable

The service runs the engine at shell start and every 15 minutes. Records for every detected agent appear within seconds; the Agents panel grows a chip per agent (`h`/`l` to switch).

To fully uninstall:

omarchy plugin remove rohaquinlop.agent-collectors
rm -f ~/.local/state/omarchy/agents/usage/pi.json \
      ~/.local/state/omarchy/agents/usage/opencode.json
rm -rf ~/.cache/omarchy/agent-collectors

How it works

adapters//manifest.json   declarative source + field map ┐
~/.config/omarchy/agent-collectors/adapters//…           ├→ engine → ~/.local/state/omarchy/agents/usage/.json
(optional) collect/limits hooks                              ┘

Per run the engine:

Discovers adapters — built-in adapters/, then the user dir (same id = user wins).
Filters: skips an id when an official omarchy-agent-usage- collector exists (superseded), when disabled via widget settings, or when its detect paths are missing.
Collects canonical events {ts, session, model, kind, input, output, cacheRead, cacheWrite}.
Aggregates today / last-7-days / all-time / per-model token buckets.
Writes .json atomically (temp + rename, mode 600). One failing adapter never blocks others.

State (per-file parse caches) lives in