Omarchy T3 Code

T3 Code as an Omarchy desktop app, with a status widget in your bar. A lightweight QML interface with a Rust backend.

Models and favorites	Live chat and file changes
Thread actions	Pull requests

Follow local and remote coding sessions, write prompts, attach files and respond to questions without keeping the official T3 desktop GUI open. The panel uses your Omarchy theme and inherits T3's connections, models and favorites.

Highlights

• Live messages, contextual work indicators, tasks, queues and changed files.
• Durable drafts, expanded prompt editor, mentions, skills and commands.
• Image/file/HTML previews inside the panel; copy messages and images.
• QML previews of qml code blocks, inline or in the side panel, in a sandboxed Qt process (allowed Qt imports only; no network, file access or launches; Omarchy colours as omarchy.background, .foreground, .accent…).
• Thread actions, branch/PR badges, conversation minimap and a PR browser.
• Subscription usage bars and work/ready/input badges on your desktop bar.
• A desktop app in its own process: a stuck bar never blocks it; minimize it to the bar widget.
• Resizable layout, keyboard navigation, smooth scrolling and 20 languages.
• Native headless server controls and automatic startup for inherited SSH connections.
• Preferences for native general/Git settings, Omarchy appearance, connections and model favorites.

Install

Requires Omarchy's Quickshell shell/plugin manager. Run as your desktop user, from your desktop session:

curl -fsSL https://raw.githubusercontent.com/avillagran/omarchy-t3-code/main/install.sh | bash

The installer installs runtime dependencies through Pacman and, when T3 Code is missing, T3 Code nightly (t3code-nightly-bin, from Omarchy's repository or the AUR through yay/paru). If T3 has never been opened it opens it once, so T3 creates its profile and t3 CLI. It then downloads verified aarch64 / x86_64 binaries and installs Omarchy T3 Code as a desktop app: an "Omarchy T3 Code" entry in the app launcher, ot3 on your PATH, a hidden start at login and Super+Shift+A as your default agent on Omarchy's Lua configuration. It also enables the optional bar widget, which shows work/ready/input badges and minimizes the window to the bar (OT3_BAR_WIDGET=0 installs the app alone). It reuses an existing T3 server or starts the native headless service when stopped. It also installs the pinned, checksum-verified OmaBridge CLI next to the client. Your T3 connections and data stay in place. The same command updates a clean Git installation. It may request your sudo password and restarts the Omarchy shell when finished.

The app runs in its own process, not inside the Omarchy shell: if the bar gets stuck, Super+Shift+A and the launcher keep working, and restarting the shell does not close your chats. Installed from the Omarchy plugin marketplace instead, the same folder works as a plugin: its bar widget starts the app hidden and shows or hides it on click; run ~/.config/omarchy/plugins/omarchy-t3-code/bin/ot3 install-desktop to add the launcher entry and ot3 command as well.

Use

Press Super+Shift+A, open Omarchy T3 Code from the app launcher or click T3 in the status bar to show the agent; the same shortcut or click hides it again (the header's – button and closing the window minimize it to the bar, the app keeps running). ot3 quit stops it and ot3 restart applies an update. Enter sends; Shift+Enter inserts a new line. Ctrl+Enter also sends. Super+Enter keeps Omarchy’s terminal shortcut. The header’s window button cycles panel (under the bar’s T3 button, with the bar widget) → floating → tiled, keeping the same chat and draft. Add projects through the embedded environment and folder picker, including remote folders. Use the header buttons for subscription usage and pull requests, and right-click a thread for its actions. F1 opens keyboard help.

Manage saved connections in Preferences → Connections: add SSH hosts or pairing links, edit routes, rename, reconnect, switch off or remove them. Ot3 uses T3’s native encrypted catalog. If the official GUI owns the server, close it and use the sidebar's start button to run headless. The plugin does not stop a GUI-owned server. Inherited SSH connections reuse a running remote server or start its native headless service when stopped. Open the sidebar gear for preferences; server settings apply to the selected environment. ot3 bundles OmaBridge: once devices are paired, SSH and pairing-link connections go through them first, without a VPN, and fall back to the saved route. Pair, approve, revoke, publish and manage your devices in Preferences → Connections → OmaBridge or from the optional bar indicator: the same page as the Omarchy Control Panel, on the same device.

Some T3 features are still being ported, and the PR view is currently read-only. See the feature parity checklist.

Development

Build instructions, architecture, the shared Rust library for Omi, keyboard integration and validation commands live in the development guide. The portable protocol is maintained separately in lib-t3-rust, shared with Omi and consumed at a pinned revision.

Credits

Evolved from Omarchy Ares, inspired by T3 Code, with Lucide icons. Independent community project. MIT License · Asset attribution.