██████╗ ███╗   ███╗ █████╗ ███████╗██╗  ██╗
██╔═══██╗████╗ ████║██╔══██╗██╔════╝██║  ██║
██║   ██║██╔████╔██║███████║███████╗███████║
██║   ██║██║╚██╔╝██║██╔══██║╚════██║██╔══██║
╚██████╔╝██║ ╚═╝ ██║██║  ██║███████║██║  ██║
 ╚═════╝ ╚═╝     ╚═╝╚═╝  ╚═╝╚══════╝╚═╝  ╚═╝

omash is forked from Clash Verge Rev and reworked as a fast, native terminal dashboard for Mihomo, built for Omarchy. It carries the upstream Mihomo management design into a Rust TUI without a browser runtime.

The TUI is only the control surface. Mihomo runs under a user-level supervisor, so closing omash does not stop your proxy.

Built for Omarchy

• Uses system packages. omash runs /usr/bin/mihomo and reuses the Country.mmdb provided by clash-geoip. Mihomo and GeoIP updates stay with pacman and omarchy update.
• Starts with your desktop session. omash-supervisor.service is attached to graphical-session.target. It starts Mihomo on login, restarts it after a crash, and keeps it running when the TUI exits. You can toggle login startup from Settings.
• Follows the active Omarchy theme. The TUI reads the current Omarchy color palette and updates live when the theme changes. No restart or theme setup is required.
• Handles proxy variables for Omarchy apps. System Proxy updates both gsettings and the UWSM/systemd user environment. Newly launched apps, including Chrome, inherit the current proxy settings.
• Includes an Omarchy Shell widget. The optional Quickshell bar widget can change the routing mode, select proxies, and run delay tests without opening the TUI.

Install

On Omarchy, run:

curl -fsSL https://raw.githubusercontent.com/ourongxing/omash/main/scripts/install | bash

The installer adds mihomo and clash-geoip through Omarchy, installs the Rust toolchain when cargo is unavailable, builds the release tag pinned by the installer, and installs the binary and user service. Temporary source and build files are removed when it exits.

To build and install from source instead:

omarchy pkg aur add mihomo clash-geoip

# Run these two commands only when Cargo is not already installed.
omarchy install dev-env rust
source "$HOME/.cargo/env"

git clone https://github.com/ourongxing/omash.git
cd omash
cargo build --locked --release
sudo install -Dm755 target/release/omash /usr/bin/omash
sudo install -Dm644 systemd/omash-supervisor.service \
  /usr/lib/systemd/user/omash-supervisor.service
systemctl --user daemon-reload

Run the dashboard:

omash

On first launch, omash creates its configuration, enables the user service when auto_start is enabled, and starts the supervisor for the current session. It also generates a random API secret; you do not need to configure or start Mihomo separately.

What it does

• Imports local YAML profiles and remote subscriptions
• Validates profile changes before replacing the running configuration
• Switches Rule, Global, and Direct modes
• Selects proxies and runs delay tests
• Shows and closes active connections
• Supports Merge, prepend/append, Rules, Proxies, and Groups enhancements in native Rust
• Controls the system proxy, LAN access, IPv6, and refresh intervals
• Updates remote subscriptions on schedule
• Creates and restores local ZIP backups
• Shows Mihomo logs and package versions

The Mihomo management behavior comes from Clash Verge Rev's Rust implementation, adapted to a native TUI and Omarchy's system layout.

Controls

The layout uses a sidebar in wide terminals and switches to a top navigation bar when space is limited. Press ? at any time to show all shortcuts.

Key	Action
1-8	Open a page
Up / Down, j / k	Move the selection
Tab, Left / Right, h / l	Switch between proxy groups and nodes
Enter	Run the selected action
r	Refresh now
?	Toggle shortcut help
q, Ctrl-C	Exit the TUI without stopping Mihomo

Mouse clicks, scrolling, and double-click actions are also supported.

Omarchy Shell widget

The widget requires the omash binary installed above. Add it to Omarchy Shell directly from the public repository:

omarchy plugin add https://github.com/ourongxing/omash.git --enable

The widget appears in the bar immediately through Omarchy Shell's hot reload. Its two-column panel lists selector groups on the left and their proxies on the right. It preserves the order from your Mihomo profile, shows current selections and measured delays, and switches between Rule, Global, and Direct modes.

The widget calls omash bar and never reads or copies the Mihomo API secret. The omash binary must be available on the Shell's PATH. Its refresh interval can be changed from 2 to 60 seconds in the plugin settings.

Remove

Remove the Shell widget, user service, and installed binary with:

omarchy plugin remove ourongxing.omash --yes
systemctl --user disable --now omash-supervisor.service
sudo rm -f /usr/bin/omash /usr/lib/systemd/user/omash-supervisor.service
systemctl --user daemon-reload

The removal commands preserve your configuration, profiles, logs, and backups. To delete those user files too, remove ~/.config/omash and ~/.local/share/omash after making any backup you want to keep.

Theme overrides

By default, omash continuously follows the current Omarchy palette. To use a separate TUI theme instead, create ~/.config/omash/theme.toml:

mkdir -p ~/.config/omash
cp themes/default.toml ~/.config/omash/theme.toml

Theme overrides reload while omash is running. Remove the file to follow Omarchy again. All colors use #RRGGBB; see themes/default.toml for the available fields.

Configuration

The main configuration file is ~/.config/omash/config.toml. Runtime data, profiles, logs, and backups live in ~/.local/share/omash/.

controller = "http://127.0.0.1:9090"
secret = ""
refresh_ms = 1500
delay_test_url = "https://www.gstatic.com/generate_204"
auto_start = true
mixed_port = 7897
allow_lan = false
ipv6 = true
system_proxy = true
proxy_bypass = "localhost,127.0.0.1,::1,192.168.0.0/16,10.0.0.0/8,172.16.0.0/12"

OMASH_REFRESH_MS and --refresh-ms override the configured refresh interval. Use --config <path> to load a different configuration file.

Development

cargo test
cargo build --release

License

As a fork of Clash Verge Rev, omash remains licensed under GPL-3.0-only. The full, unmodified license is retained in LICENSE.