| name | zentty-cli |
| description | Use when an agent is running inside Zentty or needs to discover panes, split or grid layouts, focus panes, launch nested coding agents, or notify the user through the Zentty CLI. |
Zentty CLI
Zentty injects a pane-aware CLI into sessions running inside the app. Use it to inspect the current terminal layout, control panes and worklanes, launch supported agents with Zentty status hooks, and notify the user when work needs attention.
Detect Zentty
Prefer the injected binary:
ZENTTY="${ZENTTY_CLI_BIN:-zentty}"
You are inside a controllable Zentty pane when these are set:
test -n "${ZENTTY_INSTANCE_SOCKET:-}" &&
test -n "${ZENTTY_WORKLANE_ID:-}" &&
test -n "${ZENTTY_PANE_ID:-}" &&
test -n "${ZENTTY_PANE_TOKEN:-}"
If they are missing, do not assume pane control works. Explain that the command must run from a Zentty pane, or use ordinary shell behavior.
Operating Rules
- Use
$ZENTTY_CLI_BIN when available; it points at the bundled CLI for the running Zentty app.
- Prefer
--json for discovery and parse IDs from JSON instead of scraping table output.
- Default to the current pane/worklane. Only target other panes with explicit selectors.
- Treat
ZENTTY_PANE_TOKEN and --include-control-token output as sensitive routing credentials. Do not print them unless needed for a concrete command.
