# 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, 15 contributors. MIT license.

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

## Contributors

15 people have contributed to Infomarchy. Here is what each of them added, from their merged pull requests.

### Fred Nix (@nixfred)

Author and maintainer. Created Infomarchy and maintains it. Reviews and merges every contributor pull request.

GitHub: https://github.com/nixfred

### TechLuddite (@TechLuddite)

9 merged pull requests. Added Web Mode, a browser view of the desk for phones and other computers over a trusted LAN, Tailscale or your own HTTPS certificate. Also added the optional media controls and containers cards, Pi session support, animated image wallpapers and hardening of the collector.

GitHub: https://github.com/TechLuddite

Pull requests: https://github.com/nixfred/infomarchy/pull/25 https://github.com/nixfred/infomarchy/pull/19

### Adam (@alinuxfan)

2 merged pull requests. Added Antigravity (agy) as a recognised agent provider. Also removed an accidentally committed node_modules symlink that made plugin updates fail validation.

GitHub: https://github.com/alinuxfan

Pull requests: https://github.com/nixfred/infomarchy/pull/24 https://github.com/nixfred/infomarchy/pull/27

### Augustin Bralley (@auggernaut)

2 merged pull requests. Added the optional APPS module, which registers local development servers and manages them as systemd user services. Also made the SUPER+I shortcut setup explicit in the README.

GitHub: https://github.com/auggernaut

Pull requests: https://github.com/nixfred/infomarchy/pull/36 https://github.com/nixfred/infomarchy/pull/29

### jaylfc (@jaylfc)

2 merged pull requests. Added Kimi Code as a tracked agent provider. Also made the desk stay clear of reserved background bands such as the hymission stage sidebar.

GitHub: https://github.com/jaylfc

Pull requests: https://github.com/nixfred/infomarchy/pull/32 https://github.com/nixfred/infomarchy/pull/31

### John Trainor (@jttraino)

2 merged pull requests. Added Cursor session detection from both the terminal and the Cursor IDE. Also grouped quiet agents of one kind into a single card, so a long Grok Bot roster no longer crowds the desk.

GitHub: https://github.com/jttraino

Pull requests: https://github.com/nixfred/infomarchy/pull/34 https://github.com/nixfred/infomarchy/pull/33

### Reverb (@reverb256)

2 merged pull requests. Fixed live Hermes session detection when Hermes is launched as python -m hermes_cli.main. Also made the desk refresh sooner by watching Hermes state files on top of the regular poll.

GitHub: https://github.com/reverb256

Pull requests: https://github.com/nixfred/infomarchy/pull/11 https://github.com/nixfred/infomarchy/pull/39

### David R (@Tech0001)

2 merged pull requests. Fixed wallpaper stretching on ultrawide and portrait displays. Also added a Gitea activity card next to the GitHub one.

GitHub: https://github.com/Tech0001

Pull requests: https://github.com/nixfred/infomarchy/pull/28 https://github.com/nixfred/infomarchy/pull/30

### Wulf Kaal (@wulfkaal)

2 merged pull requests. Added the REMOTE card, an optional read-only roster of agents on other machines. Also added a switch to turn off automatic topic refinement for people who tunnel to a remote Ollama.

GitHub: https://github.com/wulfkaal

Pull requests: https://github.com/nixfred/infomarchy/pull/13 https://github.com/nixfred/infomarchy/pull/12

### Danny Welch (@dannyowelch)

1 merged pull request. Fixed the desk so it keeps clear of the bar on whichever screen edge the bar sits, including when the bar moves or is hidden.

GitHub: https://github.com/dannyowelch

Pull requests: https://github.com/nixfred/infomarchy/pull/40

### Greg (@eternal4430)

1 merged pull request. Built the FLEET card, which shows AI agents running on other machines over SSH. Also read Hermes and OpenRouter usage into the Usage and Limits card.

GitHub: https://github.com/eternal4430

Pull requests: https://github.com/nixfred/infomarchy/pull/35

### Greyforge Labs (@GreyforgeLabs)

1 merged pull request. Fixed the disk card so volumes with spaces in their mount path are no longer dropped.

GitHub: https://github.com/GreyforgeLabs

Pull requests: https://github.com/nixfred/infomarchy/pull/41

### RidgetopAi (@RidgetopAi)

1 merged pull request. Added FLEET sessions, which show which agent on a remote host is waiting on you and give a one click jump to it.

GitHub: https://github.com/RidgetopAi

Pull requests: https://github.com/nixfred/infomarchy/pull/37

### Casey Shields (@shieldsworks)

1 merged pull request. Added a setting that pins the desk to one workspace while the wallpaper stays on all of them.

GitHub: https://github.com/shieldsworks

Pull requests: https://github.com/nixfred/infomarchy/pull/38

### sooners0 (@sooners0)

1 merged pull request. Made Hermes sessions appear in Recent Tasks, read from the Hermes local session history.

GitHub: https://github.com/sooners0

Pull requests: https://github.com/nixfred/infomarchy/pull/10

Contributor list and pull requests from GitHub, October 28, 2026. Bots are not listed.

## In the wild

Public posts on X from people who use it, quoted word for word. A few are excerpts of a longer post.

> 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

> Seeing the subscription burn right next to the running agents is the useful part. Most people have no idea what their agents cost until the bill shows up.

Sami Daar (@SamiDaarx) on X, about Infomarchy: https://x.com/SamiDaarx/status/2114419418822271090

> wallpaper as agent status board is the correct 2026 desktop. pulsing dots > dock icons.

Guilty Geek (@Guilty0399887) on X, about Infomarchy: https://x.com/Guilty0399887/status/2096120618986959228

> Infomarchy is a great tool for anyone wanting to keep track of their agents on Omarchy. Another great product from @NixFred.

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

> I'm still using 5 or 6 harnesses like a crazy person, before Infomarchy a reboot was a nightmare and now i just click back into anything and everything!

TechLuddite (@gh_TechLuddite) on X, about Infomarchy: https://x.com/gh_TechLuddite/status/2108092026965410196

> dear god, this is so freaking cool. i am happy that i lived long enough to see computers become fun again.... while still being useful. thanks for your work, adding now

With Further Ado (@withfurtherado) on X, about Infomarchy: https://x.com/withfurtherado/status/2096642488165363979

> My favorite plugin.  This one is a must-have.

Danny Welch (@dannyowelch) on X, about Infomarchy: https://x.com/dannyowelch/status/2114535413427945664

> the sub burn widget is the part i'd stare at all day

lowercase ceo (@lowercaseceo) on X, about Infomarchy: https://x.com/lowercaseceo/status/2114396024731037937

> I run Infomarchy on my Omarchy installs. You should too

Mike Gannotti (@MichaelGannotti) on X, about Infomarchy: https://x.com/MichaelGannotti/status/2114494849793851649

## 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
