dsh-omarchy-agent: Wiring DeepSeek Harness into Omarchy's Default Agent System
yorelog/dsh-omarchy-agent
Wires DeepSeek Harness into Omarchy as a general-purpose agent, adding Omarchy tools, an agent preset, and one-command desktop integration so the dsh TUI becomes the default agent.
dsh-omarchy-agent is a DSH plugin that makes dsh a system-aware general-purpose agent on Omarchy, the Arch Linux plus Hyprland desktop. It closes the gap between dsh and Omarchy's default-agent system, so omarchy agent, the Agent keybinding, and the picker all open the dsh terminal UI. It bundles five tools for status, catalog, theme, Hyprland, and diagnostics, a guard that denies writes under /usr/share/omarchy, and an Omarchy-aware Omarchy General preset, while preparing web, headless, and tui profiles with the browser UI just one --web flag away.
How to Install
dsh plugin --profile web add dsh-omarchy-agent- Category
- Tools & Capabilities
- Platform
- DSH Plugin
- Author
- yorelog
- Distribution
- Plugin
dsh-omarchy-agent Key Features
dsh-omarchy-agent Repo Summary
What Does It Do?
Omarchy Agent is a DSH plugin for DeepSeek Harness that turns dsh into a general-purpose, Omarchy-aware agent on Arch Linux with Hyprland. It solves the gap between dsh and Omarchy's default-agent system, so omarchy agent, the Agent keybinding, and the picker all open the dsh terminal UI. Maintained by yorelog under the MIT license, it ships Omarchy-specific tools, a safety guard for package-owned files, an Omarchy General agent preset, and one-command desktop integration.
Core Features
- Omarchy tool set: five tools cover status, catalog, theme, Hyprland, and diagnostics, reading distro build, theme, monitors, workspaces, active window, and failed units, and supporting theme switching and config reloads.
- Safety guard: a pre-execute hook denies writes under
/usr/share/omarchyand asks for approval before privileged or system-mutating shell commands. - Omarchy General preset: a general-purpose coding agent with an Omarchy-aware persona, backed by system-prompt conventions that prefer Omarchy tooling, read before changing, and keep user changes under
~/.config. - Desktop integration: wires dsh into Omarchy's default-agent system, adds a picker row, sets dsh as the default agent, and overrides the
aalias and Agent keybinding. - Multiple run modes: prepares web, headless, and tui profiles, with the browser UI just one
--webflag away.
How to Use This Plugin?
After enabling it in DSH, set your DeepSeek key and launch the dsh terminal UI to start chatting. Press SUPER + SHIFT + CTRL + A, or summon the Omarchy menu and pick DeepSeek Harness, to reach the same interface; add --web for the browser UI, --prompt for a one-shot request, --pick to open the agent picker, or --set to switch the default agent back. The installer checks for dsh and pnpm, creates the profiles, and installs the launcher and shims, with every step idempotent and individually disableable; a dry-run mode shows changes first, and removal follows the official instructions by running the uninstall script from the plugin directory before removing the plugin.
How to Troubleshoot This Plugin?
If the integration does not take effect, first check whether the Omarchy plugin service detected the missing agent integration and completed installation; its log lives at ~/.local/state/dsh-omarchy-agent/install.log, it sends a notification when finished, and it never repeats on later shell starts. If a step is unwanted, disable it individually with --no-default, --no-menu, --no-alias, --no-keybind, --no-headless, --no-tui, or --no-shim and rerun.
This page is an independent rewrite of the plugin's official README — for authoritative documentation and the latest changes, refer to the source: yorelog/dsh-omarchy-agent. The plugin is third-party code that runs on your machine once installed; inclusion does not imply endorsement — please review the source before installing.