carsol

Herdr Mobile — Design skill for Claude Code

Design community

Mobile-first web UI for Herdr: see your agents, attach to panes, chat with Claude Code and Codex from your phone.

How to install Herdr Mobile

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

What Herdr Mobile does

Mobile-first web UI for Herdr: see your agents, attach to panes, chat with Claude Code and Codex from your phone.

Alternatives in Design

  • Od Contribute — Open a first-contribution PR (or bug issue) on nexu-io/open-design — works for non-coders too 91.8k ★
  • CloudCLI — 8,400+ Free open-source web/mobile UI for Claude Code, Cursor CLI, and Codex 8.7k ★
  • NotebookLM Automation — Complete programmatic access to Google NotebookLM—including capabilities not exposed in the web UI 6.8k ★

README

herdr-mobile

A mobile-first web UI for [Herdr](https://herdr.dev). See every agent pane from your phone, watch its status, attach to the real terminal, send prompts, and read Claude Code / Codex conversations as chat bubbles.

Pure Python standard library. No build step or Python dependencies.

Features

  • Session list grouped by workspace, with Herdr's native agent status (working / blocked / done / idle) and live updates.
  • Terminal view — xterm.js attached to the pane over a WebSocket, real resize, a phone-friendly key row (esc, tab, arrows, ^C…), and a prompt bar so you can type long messages without fighting the on-screen keyboard.
  • Chat view for Claude Code and Codex panes — the agent's transcript rendered as an iMessage-style conversation, tool calls collapsed.
  • Spawn a new agent (claude, codex, gemini, pi, opencode, …) in any directory, straight from the phone.
  • PWA — add to home screen and it behaves like an app.
  • Optional passcode.

Requirements

  • Herdr 0.8 or newer, running on macOS or Linux
  • Python 3.10 or newer

Install and start Herdr if needed:

curl -fsSL https://herdr.dev/install.sh | sh
herdr

Install as a Herdr plugin

herdr plugin install carsol/herdr-mobile

The plugin starts the web UI with Herdr. Run **Show mobile URL** from Herdr's plugin actions, or open `http://127.0.0.1:9080` on the same machine.

For development, run it directly from a checkout:

git clone https://github.com/carsol/herdr-mobile.git
cd herdr-mobile
python3 -m herdr_mobile

To reach it from a phone, set `HERDR_MOBILE_HOST` to your Tailscale IP (or `0.0.0.0`) and set `HERDR_MOBILE_PASSCODE` before starting the app. Do not expose port 9080 directly to the internet.

Configuration

Everything is an environment variable:

Variable Default Meaning
HERDR_MOBILE_HOST 127.0.0.1 Bind address. Use 0.0.0.0 (or your Tailscale IP) to reach