AI

Omarchy ships with OpenCode as the default agent harness for programmers. It's a great way to use models from all the major commercial providers as well as the rapidly improving open-weight models. The best way to use OpenCode is by going to the directory you're going to work on in the terminal, then invoke the c alias to start OpenCode within that directory.

Dictation

Omarchy offers AI dictation via Voxtype. You install it via Install > AI > Dictation through the Omarchy menu. By default, it'll load a base English model that takes up 150MB. But you can tweak which model you'd like to use by running voxtype setup model in the terminal. And you can tweak all the settings via ~/.config/voxtype/config.toml.

Once you're installed, you dictate by holding down Super + Ctrl + X, and once you release, the dictated text will appear in the focused input area.

The Omarchy Skill

Agent skills help AI use specific tools in a specific way, and Omarchy ships with a default skill for tailoring the system. Like making changes to waybar or even creating a new theme from scratch. It's automatically configured in OpenCode (and Claude Code and any other harness that supports ~/.claude/skills).

But you should treat this skill as experimental. Different models will use it to different effect. It's best to run in plan mode first, so you have an idea of what the agent would like to change. And then be ready to rollback changes or even invoking omarchy-reinstall-configs, if the agent makes a mess of everything.

Local LLMs

Omarchy recommends two ways of running local LLM models: LM Studio and Ollama. LM Studio provides a GUI interface for finding open-weight models, installing them, and running them. It's a great way to get going easily. Ollama offers a CLI for doing so similarly. But if you're new to local models, I'd start with LM Studio. You can install either under Install > AI in the Omarchy Menu.

Other agent harnesses

If you don't want to use OpenCode as a multi-model harness, you can also install the provider-specific harnesses from Install > AI. You'll find Claude Code, Gemini CLI, OpenAI Codex, GitHub Copilot here.

You also have access to Crush, which is an alternative to OpenCode by the excellent crew at Charm (who makes the gum TUI tool that much of Omarchy is built with).