Omusey: Muse in the Omarchy bar

# Omusey

**[Muse](https://muse.ai/) in the [Omarchy](https://omarchy.org) bar.** Click the avatar and your Muse chat drops down from the top of the screen. Click again and it tucks away, still loaded, right where you left it.

![The Muse chat dropped down from the Omarchy bar](assets/hero.png)

No new window to manage, no tab to find. When you do want a full window, the `pop out` tab under the dropdown's corner turns it into one.

## Install

```sh
omarchy plugin add https://github.com/telep-io/omusey.git --enable
omarchy restart shell
```

That's it. The widget lands in the center of the bar; move it with `omarchy bar move telep.muse --section right` (or `left`).

The first click opens muse.ai as an Omarchy web app, so you sign in once, in your own browser, like on any other site. After that the chat is one click away.

### Requirements

Everything below ships with Omarchy; there is nothing extra to install.

- Omarchy Quattro (the Quickshell-based shell, Hyprland with Lua config)
- A Chromium-based default browser (Chromium, Brave, Chrome...) for the web app window
- `jq`

### Remove

```sh
omarchy plugin remove telep.muse
```

It leaves nothing behind: no config edits, no state files, no services.

## Use

![The avatar in the bar](assets/bar.png)

| Action | Result |
|---|---|
| Click the avatar | Drop the chat down, or tuck it away |
| Click `pop out` (just below the dropdown's bottom-right corner) | Turn the dropdown into a normal tiled window on the current workspace |
| Click the avatar while popped out | Focus that window |
| Close the popped-out window, then click the avatar | A fresh dropdown |

The dropdown opens on whichever monitor you clicked, centered under the avatar. Tucked away, Muse keeps running, so a reply that was streaming is finished when you come back.

<img src="preview.png" width="390" alt="The dropdown with the pop out tab below its bottom-right corner">

## Settings

Set from the bar's widget settings, or from a terminal:

```sh
omarchy bar set telep.muse width 560             # dropdown width in px, 360-1200 (default 480)
omarchy bar set telep.muse heightPercent 70      # dropdown height, % of the screen, 30-90 (default 60)
omarchy bar set telep.muse avatar ~/Pictures/my-muse.png
```

Size changes apply the next time the dropdown opens.

### Your own avatar

Out of the box the bar shows the Muse mark. The screenshots above show