agents

A coding-agent launcher, crash diagnosis and usage panel for any Linux desktop. It's a port of the agent tooling in Omarchy that doesn't depend on Omarchy, Hyprland or Nix, and works with Claude Code, OpenCode, Codex, Hermes and Pi.

• agent starts your default agent in a new terminal, or on a prompt: agent, agent codex, agent pick, agent prompt "why is my wifi slow", agent default opencode.
• Crash diagnosis. When one of your programs dumps core, a notification offers to hand it to the agent along with the diagnose-crash skill. agent crash-mute <program> silences one.
• Usage. agent usage shows each agent's token use and rate limits in the terminal. With Quickshell installed, agent panel toggles a panel with the same data and a few troubleshooting starters.

Install (Fedora, Ubuntu)

git clone https://git.avgtechguy.com/avgtechguy/agents.git ~/.local/src/agents
~/.local/src/agents/install.sh

The installer doesn't use sudo. It lists any missing packages with the dnf or apt command to install them. The agent CLIs come from their own installers. Settings are in ~/.config/agents/config.sh, which the first run writes and later runs leave alone.

To update, git pull and run install.sh again. install.sh --uninstall removes everything except your settings and usage history.

Optional extras:

• Crash notifications need notify-send and coredumpctl. On Ubuntu that means libnotify-bin and systemd-coredump, which takes crash handling over from apport.
• The panel needs Quickshell and a compositor with wlr-layer-shell (COSMIC, Hyprland, KDE, Sway). On Fedora, Quickshell is in the errornointernet/quickshell COPR. Ubuntu doesn't package it, so it has to be built from source.
• COSMIC shortcuts. If you have no custom shortcuts yet, the installer binds Super+Ctrl+A to the panel and Super+Ctrl+Shift+A to the agent. Otherwise it prints the two lines to add.

Nix

NixOS and Home Manager hosts install this through the myAgents module in nix-config, which takes this repo as a flake input. Nothing here needs Nix, and the scripts in bin/ don't know which installer set them up: both define the same AGENTS_* variables before running them.

Layout

Path	What it is
bin/	The launcher, crash watcher and usage scripts
collectors/	One usage collector per agent. Each prints a JSON record.
panel/	The Quickshell panel
skills/	Skills linked into each agent's skills folder
install.sh	The installer for systems without Nix
update-upstream.sh	Refreshes the files copied from Omarchy

collectors/claude.py, collectors/codex.py and panel/assets/ are copied unchanged from Omarchy at the commit in UPSTREAM_REV. Everything else is written for this repo.

License

MIT, as is Omarchy, which this is derived from. See LICENSE.