banxxrr

Claude Bridge — Development skill for Claude Code

Development community

Keeps your machine reachable for Claude Code dispatch: starts Claude Desktop with your session, restarts it if it dies, and shows bridge status in the Omarchy bar.

How to install Claude Bridge

This entry records only its repository, not the path inside it, so there is no exact command to give. Open banxxrr/claude-bridge and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Claude Bridge does

Keeps your machine reachable for Claude Code dispatch: starts Claude Desktop with your session, restarts it if it dies, and shows bridge status in the Omarchy bar.

Alternatives in Development

README

Claude Bridge

**Keeps this machine reachable for Claude Code dispatch** — so you can start a new session from your phone or from claude.ai and have it run here, without setting anything up first.

Claude Desktop is what hosts that bridge, so the bridge is only up while it is running. This plugin makes sure it is: it starts Claude Desktop with your session, brings it back if it dies, and parks its window on a hidden workspace rather than quitting it to get it out of the way. A bar icon confirms the bridge is live at a glance, and a menu gives you launch, quit, and show/hide.

Closing Claude Desktop's window only hides it to the tray, so "is the window open" tells you nothing about whether dispatch works. This answers the question that actually matters — and acts on it.

![Claude Bridge on the Omarchy bar: the menu open, and the three icon states](preview.png)

**Recommended: have a coding agent install this.** Setup touches your Hyprland config — an autostart entry, a window rule and a keybinding — and those differ by Hyprland version, by config layout (Lua vs `.conf`), and by which keys you already have bound. An agent reconciles that against your actual machine; a copy-pasted snippet cannot.

Point Claude Code at this repo and say:

Install https://github.com/banxxrr/claude-bridge and follow its SETUP.md

[SETUP.md](SETUP.md) is written for that: it states the desired end state and the constraints rather than a fixed list of commands. Prefer to do it by hand? See [Install](#install) below — `./setup.sh --dry-run` prints every change before it makes one.

Always on

Setting Default Behaviour
autostart true Starts Claude Desktop when the bar loads, i.e. every login
keepAlive true Restarts it if it exits unexpectedly

**A deliberate quit is respected.** Quitting from the widget sets a hold, so `keepAlive` will not immediately undo what you asked for. The hold c