---
title: "alis herdr"
url: "https://docs.alisx.com/reference/cli/herdr/"
---
# alis herdr

Integrate Alis with herdr, the terminal multiplexer the CLI can run inside: link the Alis plugin and inspect the current session.

## Synopsis

```bash
alis herdr install [flags]
alis herdr status [flags]
```

## Description

Inside herdr, every pane knows its service: the pane is titled `<org>.<product> / <service>` and carries `alis_org`, `alis_product` and `alis_neuron` tokens for its working directory. Outside `~/alis.build` nothing changes. herdr 0.9.0 or later is required.

## Subcommands

### alis herdr install

Link the Alis herdr plugin and bind its shortcuts. Prefix is Ctrl+B. Keys already taken are left alone; bind the plugin actions yourself in that case. The plugin manifest pins the CLI's exact path and version, so a CLI upgrade re-links it; re-run install after moving the CLI. Install also unlinks the retired `alis.handoff` plugin.

```bash
alis herdr install [flags]
```

| Shortcut | Plugin action | What it does |
|---|---|---|
| `prefix+a` | `alis.build.navigate` | Opens the TUI in a popup at the invoking pane's service; `q` or Ctrl+C closes it. |
| `prefix+y` | `alis.build.approve` | Approve a production deploy that was refused for confirmation: a popup shows the exact retry and runs it only on `y`. |
| `prefix+d` | `alis.build.board` | Operations board beside the pane: every operation this machine started, polled every 5 s. `q` closes it. |
| `prefix+m` | `alis.build.memory` | Save a coding-agent session to Alis (`alis context push-session`; its own `[y/N]` is the consent). |
| `prefix+i` | `alis.build.ask` | Ask across your skills, sessions and specialist conversations, scoped to the pane's service. |
| `prefix+t` | `alis.build.handoff` | Hand the focused Claude or OpenCode pane off to a workstation. |
| `prefix+u` | `alis.build.reclaim` | List this laptop's handoffs; bring one back. |

herdr has no palette for plugin actions; a key or `herdr plugin action invoke <action>` reaches them.

No flags beyond the global flags.

### alis herdr status

Inspect the current herdr session and the Alis plugin link: the session, version, plugin link and whether the link is stale.

```bash
alis herdr status [flags]
```

No flags beyond the global flags.

## Examples

```bash title="Terminal"
alis herdr install
alis herdr status --json
```

## Notes

- Without herdr installed, `status` exits 1 with an `ERROR` envelope naming the missing executable.
- `alis build`, `alis deploy`, `alis define` and `alis operations wait` run inside a pane toast their outcome; a production deploy refused for confirmation labels the pane and offers the approve action.