Omarchy Bot. Your agents, on your desktop

Your own AI teammates. Built for Omarchy.

Give your agents a name, a shared workspace, and a desktop you can see.

Install on Omarchy See the workspace

Omarchy Bot showing a teammate sidebar and a conversation in a sample workspace — The real client, with an illustrative workspace.

A workspace for agents.
Not another chat tab.

Platform: Omarchy x86_64
Agent today: Pi
Source: Open source / MIT

A team you make your own.

Keep a research partner, a builder, or a reviewer close. Each Bot has its own identity and conversations.

Set the role. Keep the same teammate across Threads.

A role, not just a model

Name your teammates.

Give each Bot instructions and an avatar. Several Bots can use the same Agent without becoming the same teammate.

Context you can follow

Keep the work in Threads.

Responses, Thinking, and Tool Calls stay in order. Choose what to display without discarding the conversation.

Work that connects

Let your Bots talk.

Bot-to-Bot mail hands a message to another teammate in its own Thread, without copying the source conversation.

Shared files.
A screen for each Bot.

Work in one common directory. Follow desktop activity through the client, and take control when you need to.

Your work stays yours.

Bots default to ~/.omarchy-bot/workspace. Deleting a teammate doesn't delete your shared work files.

Execution stays on Omarchy.

Bot Screens run inside a private Bot Computer, separate from your Host Session. Closing the viewer doesn't stop its applications.

Read the architecture

Plugins

More tools. Familiar accounts.

Browse and install Skills across your Bots. Service account connections are not publicly available yet.

Not available yet

Connect your services.

Choose a service, connect an account, and let your Agent use its tools. Multiple accounts, without hardcoded task routing.

Google DriveGmailOutlookNotionGitHub

Available in the Bot Client

Find the right skill.

Browse skills.sh, install a skill, and keep it up to date. Let your Agent discover it, or choose it from a slash menu.

Explore skills.sh

Skills are ready to use in the Bot Client. Service account connections and the Tauri desktop client are not publicly available yet.

Make room for
a new teammate.

Already on Omarchy? Install the plugin with its official plugin manager.

Installation guide

Run in your Omarchy terminal

omarchy plugin add https://github.com/XMethues/omarchy-bot.git --enable

Use the command above to install and enable the plugin.

Omarchy on x86_64A configured Pi installation

Other Linux distributions are not currently supported. Model-provider usage is billed separately by your provider.

Before you get started.

Is this a cloud agent service?

No. The daemon, Agent workers, and Bot Computer run on your Omarchy machine. Your Agent may still use cloud model providers, so local execution does not mean all data stays offline.

Which Agents can I use today?

Pi is the currently implemented backend. Other Agents need their own adapter and verified capability support before they become selectable. The future Tauri client is not a separate execution backend.

Can I connect Google or install Skills here?

Use Plugins in the Bot Client to search and install Skills. Service account connections are not available yet. These public pages never connect to your local daemon.

Can I expose the client to the internet?

The current daemon has no application authentication. Anyone who can reach it may control Bots and their screens. Do not treat it as a secure remote-access service; client authentication is required before public release.

What happens when I delete a Bot?

Its plugin-owned records and targeted Screen runtime are removed. Shared Workspace files, Agent-owned Native Sessions, and shared Bot Computer application state are preserved.

Is Omarchy Bot free?

The source is available under the MIT license. Your model provider and any third-party services you use may charge separately. There is no hosted subscription checkout on this website.