# Infomarchy

Your wallpaper, promoted to information desk.

An Omarchy plugin under the MIT license. It draws every AI agent on your machine, what each is doing, what it cost, and how the box is holding up, live on your desktop in your current theme.

- Source: https://github.com/nixfred/infomarchy
- Site: https://infomarchy.io/
- Back to nixfred.com: https://nixfred.com/

## Install

Three commands, copied from the project README.

```bash
sudo pacman -S --needed bun   # the collector runs on bun; Omarchy does not ship it
omarchy plugin add https://github.com/nixfred/infomarchy.git --enable --yes
omarchy restart shell    # first time only: services load at shell start
```

Requirements:

- Omarchy Quattro with third-party shell plugin support
- bun (not part of the Omarchy base install)
- iw, iproute2, and ping

Optional: nvidia-smi for the GPU row, the authenticated GitHub CLI (gh) for the latest CI result and the GitHub heatmap, the omarchy.agents bar widget for the usage card, and Ollama for the local AI card.

If bun is missing, the desk says so in red at the top and in the sessions card. It fills in on the next refresh after you install bun, with no restart needed.

Ready for Omarchy 4.5: it reads the usage record from every agent collector Omarchy 4.5 ships. It also works on Qt 6.12.

## What it looks like

![Infomarchy with sanitized demo data on an empty 1080p Omarchy desktop: live AI sessions, 7-day heatmap, recent tasks, usage limits, local AI, and machine stats](https://infomarchy.io/assets/preview-1600.e5c3079fd2.webp)

Demo data. This is the real plugin on an empty Omarchy desktop in the Last Call theme, rendered with its built-in demo mode. It contains no live prompt, hostname, username, network, path, process, or session data.

## Features

### Live AI sessions

One card per running agent: Claude Code, Codex, Cursor, Grok, Gemini, Hermes, opencode, aider, Ollama chats. They are detected straight from /proc, with no agent-side hooks and nothing to configure. The dot pulses while the agent is thinking.

### Usage and limits

Session (5-hour) and weekly (7-day) rate limit meters with time to reset, plus today's prompt count and token volume. Meters turn yellow past 60% and red past 85%. It reuses the cache from Omarchy's own omarchy.agents widget, so there are no extra logins and no API keys.

### Activity and recent tasks

An hour by hour heatmap of the last 7 days of prompts across every provider. Below it, the newest prompts from all providers. Click a task from a running session to jump to its terminal.

### Machine stats

CPU, RAM, disk, Wi-Fi, WAN, live throughput, ping latency and battery. Any meter goes red when it is in real trouble.

### Hermes hosts

A read-only card for remote Hermes agent hosts. Each row shows whether the host is connected, its current task, and any pending approvals. Rows dim after 5 minutes without fresh data and turn red after 30. Unreachable hosts are flagged. Nothing on the card can approve, deny or control a host.

### Follows your theme

There are no colors in the plugin. It reads your active Omarchy theme, so switching themes re-skins the desk in place. After you add the shortcuts from the README, SUPER + I hides the cards to show your plain wallpaper, and again to bring them back.

## On GitHub

132 stars, 24 forks, 13 contributors. MIT license.

Star and contributor counts are from GitHub, October 28, 2026.

## In the wild

> I use the Infomarchy plugin from @NixFred to visualize my bots (and he PR'd my collapsed mode contribution ...)

John Trainor (@jttraino) on X, about Infomarchy: https://x.com/jttraino/status/2108604386481971253

## Part of nixfred.com

Infomarchy is one of Fred Nix's projects. See the rest at https://nixfred.com/

---

nixfred.com: https://nixfred.com/
Fred Nix, Atlanta, GA, frednix@gmail.com
