Built for Omarchy

A simple IRC client, for humans and their agents.

Omairc is a small Qt Quick app that runs one window for you and your agent to share. You chat in it. Your agent interacts with it over the CLI. Nobody has to leave the room.

Omairc showing an IRC conversation

Agent-ready CLI

The same binary controls the running window and returns one compact JSON object. Agents can read, discover, or send without another IRC connection or disturbing your selected conversation.

Use independent CLI unread cursors, target a specific network, inspect members, and verify uncertain sends before retrying.

connectionsstatussendconversationsreadnamesraise
$ omairc read '#omarchy' --since 5m
// last 5 minutes, as JSON
$ omairc send --network freenode '#omarchy' \
"pushed a fix, rerunning ci"
{"ok":true}
$ omairc read --unread

Install the agent skill

Teach compatible agents the safe Omairc CLI workflow and JSON contract.

npx skills add fredimachado/omairc/skills -g

Everything you’d want from an IRC client

The familiar IRC workflow, without plugin sprawl—and with local automation designed in from the start.

#Keyboard first

Jump, search, complete nicks, walk unread messages, and keep a draft in every conversation.

#Modern IRCv3

SASL, server-time, echo-message, metadata, account tracking, CHATHISTORY, and ZNC playback.

#Several networks

Keep each network’s channels, DMs, nick, status, and connection state in one window.

#Slash commands

Messaging, moderation, presence, preferences, services, CTCP, highlights, monitor, and more.

#Attention that behaves

Unread markers, a session inbox, highlights, mutes, and focused desktop notifications.

#History on arrival

Combine server history, resumable bouncer playback, and a recent local transcript tail.

#Secrets stay secret

Use Keychain, Secret Service, or Credential Manager instead of ordinary configuration files.

#One process

A second launch activates the existing window instead of opening a duplicate IRC connection.

#Dressed in your theme

Follow the active Omarchy palette and portal text scaling live on Linux.

Get it running

On Omarchy Edge, install the official package. On stable, rc, and other Arch-based systems, use the install script until the next Omarchy release. Windows and macOS use the current release.

Omarchy and Arch-based Linux

The Edge package is built against that channel's Qt. Updates follow Omarchy package updates.

Omarchy Edge

omarchy pkg add omairc

Omarchy stable, rc, and other Arch-based systems

curl -fsSL https://omairc.app/install.sh | sh

The install script is safe to rerun. Read install.sh before piping it, or see the full installation guide.

macOS

Install the signed app with Homebrew or a notarized archive.

brew install --cask fredimachado/omairc/omairc

Bugs, ideas, and quick chat

Durable reports go on GitHub. For a quick conversation, find us on Freenode.