Agent skill

Zentty CLI

A skill your agent uses 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.

GPL-3.0Auto-check passed

Install Zentty CLI

skills CLI

$ npx skills add dedene/zentty --skill zentty-cli -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install dedene/zentty zentty-cli --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/dedene/zentty.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/zentty-cli .claude/skills/zentty-cli && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "zentty-cli" agent skill from https://github.com/dedene/zentty/tree/main/skills/zentty-cli into .claude/skills/zentty-cli/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "zentty-cli", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/dedene/zentty/tree/main/skills/zentty-cli

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add dedene/zentty --skill zentty-cli -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install dedene/zentty zentty-cli --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/dedene/zentty.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/zentty-cli .agents/skills/zentty-cli && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "zentty-cli" agent skill from https://github.com/dedene/zentty/tree/main/skills/zentty-cli into .agents/skills/zentty-cli/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "zentty-cli", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add dedene/zentty --skill zentty-cli -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install dedene/zentty zentty-cli --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/dedene/zentty.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/zentty-cli .cursor/skills/zentty-cli && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "zentty-cli" agent skill from https://github.com/dedene/zentty/tree/main/skills/zentty-cli into .cursor/skills/zentty-cli/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "zentty-cli", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/dedene/zentty.git --path skills/zentty-cli

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add dedene/zentty --skill zentty-cli -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install dedene/zentty zentty-cli --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/dedene/zentty.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/zentty-cli .gemini/skills/zentty-cli && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "zentty-cli" agent skill from https://github.com/dedene/zentty/tree/main/skills/zentty-cli into .gemini/skills/zentty-cli/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "zentty-cli", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install dedene/zentty zentty-cli

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add dedene/zentty --skill zentty-cli -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/dedene/zentty.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/zentty-cli .github/skills/zentty-cli && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "zentty-cli" agent skill from https://github.com/dedene/zentty/tree/main/skills/zentty-cli into .github/skills/zentty-cli/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "zentty-cli", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add dedene/zentty --skill zentty-cli -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install dedene/zentty zentty-cli --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/dedene/zentty.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/zentty-cli .opencode/skills/zentty-cli && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "zentty-cli" agent skill from https://github.com/dedene/zentty/tree/main/skills/zentty-cli into .opencode/skills/zentty-cli/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "zentty-cli", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: zentty-cli
GitHub stars: 310
Token cost: ~1k tokens
SKILL.md length: 372 words
Files: 2
Skills in repo: 1
Repo updated: Oct 7, 2026
First seen: Oct 7, 2026
Licence: GPL-3.0

At a glance

A skill your agent uses 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.

An agent is running inside Zentty
SKILL.md covers Detect Zentty, Operating Rules, Discovery and Layout And Pane Control, plus 3 more sections
Needs ZENTTY_PANE_TOKEN and PANE_TOKEN
Needs to discover panes

What it does

Zentty CLI is an agent skill from dedene/zentty. 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.

Its SKILL.md is about 1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `agents/openai.yaml`).

It works with Google Gemini. The repository describes itself as: A native macOS terminal for agent-driven development, built on Ghostty. The licence is GPL-3.0.

When your agent uses it

An agent is running inside Zentty
Needs to discover panes
Launch nested coding agents
Notify the user through the Zentty CLI

Example prompts

“/zentty-cli”

Requirements

A credential in ZENTTY_PANE_TOKEN
A credential in PANE_TOKEN

What it can do on your machine

Read from SKILL.md and the folder at commit b7cfa93. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names these keys or tokens, usually read from environment variables:
- ZENTTY_PANE_TOKEN
- PANE_TOKEN
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Zentty CLI loads about 1k tokens when it runs. Until then it costs about 47 tokens; SKILL.md has 372 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~47
When it runs · the whole SKILL.md, loaded when a task matches: ~1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from dedene/zentty at commit b7cfa93, republished under its GPL-3.0 licence (© dedene). 372 words, ~1,016 tokens.

Download SKILL.mdSave it as .claude/skills/zentty-cli/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.

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:

bash

ZENTTY="${ZENTTY_CLI_BIN:-zentty}"

You are inside a controllable Zentty pane when these are set:

bash

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.
Use zentty --help or zentty <command> --help when available before guessing at a subcommand.
If a command fails with "Not running inside a Zentty instance" or "Not running inside a Zentty pane", stop and explain the missing Zentty context.

Discovery

bash

"$ZENTTY" version
"$ZENTTY" list --json
"$ZENTTY" list panes --json
"$ZENTTY" list panes --worklane-id "$ZENTTY_WORKLANE_ID" --json
"$ZENTTY" select pane --pane-index 2 --shell

Use --include-control-token only when you need to control a pane from outside its own environment:

bash

"$ZENTTY" list panes --worklane-id "$ZENTTY_WORKLANE_ID" --include-control-token --json

The token only authenticates. From outside the pane, pass the target too:

bash

"$ZENTTY" pane focus --pane-id "$PANE_ID" --pane-token "$PANE_TOKEN"

Layout And Pane Control

Common pane actions:

bash

"$ZENTTY" split right
"$ZENTTY" split down --equal
"$ZENTTY" hsplit --ratio 70
"$ZENTTY" vsplit --pane-index 2
"$ZENTTY" pane focus 2
"$ZENTTY" pane focus left
"$ZENTTY" pane resize 60%
"$ZENTTY" pane zoom
"$ZENTTY" layout thirds
"$ZENTTY" layout reset

Create grids carefully; large grids create many live panes:

bash

"$ZENTTY" grid 2x2
"$ZENTTY" grid 2x2 --new-only -- codex
"$ZENTTY" grid 2x3 --worklane-id new -- claude

Show full SKILL.md (145 more words)Show less

Launch Agents Through Zentty

When starting a nested coding agent from inside Zentty, prefer the normal wrapped command if it is already on PATH in the Zentty pane. Zentty's wrapper adds status hooks and then execs the real tool.

Use the hidden launch command only when you explicitly need to force Zentty's bootstrap path:

bash

"$ZENTTY" launch codex --model gpt-5
"$ZENTTY" launch claude --dangerously-skip-permissions

Supported launch tool names include amp, claude, codex, copilot, cursor, droid, gemini, kimi, opencode, pi, grok, agy, and hermes.

Notify The User

Use notifications for completion, blocked input, or handoff points that should bring the user back to the pane:

bash

"$ZENTTY" notify --title "Tests finished" --subtitle "Review the result"
"$ZENTTY" notify --title "Approval needed" --body "The deploy command is waiting for confirmation"

Use --silent for low-priority updates and --no-inbox when the notification should not stay in Zentty's inbox.

Manual Hook Installs

Wrapped launches usually install or inject agent hooks automatically. Manual installs are for debugging, recovery, or globally persistent integrations:

bash

"$ZENTTY" install cursor-hooks
"$ZENTTY" uninstall cursor-hooks

Check zentty install --help for the supported targets in the installed Zentty version.

Files

SKILL.md and 1 other file in skills/zentty-cli of dedene/zentty.

SKILL.md
agents/openai.yaml

Open the folder on GitHubat commit b7cfa93

Compare with similar skills

Zentty CLI next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Zentty CLI compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Zentty CLI this skilldedene/zentty	310	—	~1k	Automated safety check: Pass	GPL-3.0	yesterday
NotebookLM Research AssistantPleasePrompto/notebooklm-skill	7.8k	14 repos	~2.4k	Automated safety check: Notes	MIT	28 days ago
Brand and Design Toolkitnextlevelbuilder/ui-ux-pro-max-skill	134k	1 repos	~3.5k	Automated safety check: Pass	MIT	today
AI Image Generation and Editingzhayujie/CowAgent	47k	—	~1.3k	Automated safety check: Pass	MIT	today
ModLens Image Vision Bridgeliustack/modlens	4.2k	1 repos	~1.3k	Automated safety check: Notes	MIT	4 days ago
OpenCLI Smart Search Routerjackwener/OpenCLI	30k	2 repos	~753	Automated safety check: Pass	Apache-2.0	14 days ago

Similar skills

NotebookLM Research Assistant
PleasePrompto/notebooklm-skill
Lets Claude Code ask questions of your Google NotebookLM notebooks through browser automation and return answers grounded in your uploaded sources.
7.8k GitHub starsUsed in 14 repos~2.4k tokens
Knowledge ManagementAuto-check: notes
Brand and Design Toolkit
nextlevelbuilder/ui-ux-pro-max-skill
Bundles design tasks behind one skill: brand identity, tokens, UI styling, logos, corporate identity mockups, slides, banners, icons and social images.
134k GitHub starsUsed in 1 repo~3.5k tokens
Media & CreativeAuto-check passed
AI Image Generation and Editing
zhayujie/CowAgent
Generates or edits images from text prompts through a Python script that picks an image backend based on which API keys are configured.
47k GitHub stars~1.3k tokensUpdated today
Media & CreativeAuto-check passed
ModLens Image Vision Bridge
liustack/modlens
Gives text-only models sight by running the modlens CLI on an image path or URL and returning structured JSON evidence with transcribed text, layout and semantics.
4.2k GitHub starsUsed in 1 repo~1.3k tokens
AI & LLM EngineeringAuto-check: notes
OpenCLI Smart Search Router
jackwener/OpenCLI
Routes a search question to the most suitable opencli source, normally one AI site plus up to two specialist sites, with call limits per question and a recap at the end.
30k GitHub starsUsed in 2 repos~753 tokens
Productivity & AutomationAuto-check passed
NotebookLM Automation
teng-lin/notebooklm-py
Installs, authenticates and operates Gemini Notebook (NotebookLM) through the notebooklm-py CLI or its typed async Python API, for notebooks, sources, grounded chat and generated artifacts.
20k GitHub stars~4.1k tokensUpdated 2 days ago
Knowledge ManagementAuto-check passed

Works with

Google Gemini

Questions about Zentty CLI

What does Zentty CLI do?

A skill your agent uses 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 is an agent skill from dedene/zentty. 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.

When should I use Zentty CLI?

Zentty CLI fits situations like: an agent is running inside Zentty; needs to discover panes; launch nested coding agents; notify the user through the Zentty CLI.

How do I install Zentty CLI in Claude Code?

Run `npx skills add dedene/zentty --skill zentty-cli -a claude-code`. Or copy the skill folder (skills/zentty-cli in dedene/zentty) into .claude/skills/zentty-cli in your project. Claude Code loads it when a task matches its description.

How do I install Zentty CLI in Codex?

Run `npx skills add dedene/zentty --skill zentty-cli -a codex`. Or copy the skill folder (skills/zentty-cli in dedene/zentty) into .agents/skills/zentty-cli in your project. Codex loads it when a task matches its description.

Can I use Zentty CLI in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add dedene/zentty --skill zentty-cli -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/zentty-cli, .gemini/skills/zentty-cli, .github/skills/zentty-cli and .opencode/skills/zentty-cli in your project.

What does Zentty CLI need to run?

Going by SKILL.md and its folder, Zentty CLI needs credentials named ZENTTY_PANE_TOKEN and PANE_TOKEN. Our summary lists: A credential in ZENTTY_PANE_TOKEN; A credential in PANE_TOKEN.

Does Zentty CLI access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Zentty CLI safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Zentty CLI use?

Zentty CLI is published under the GPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Zentty CLI use?

About 1k tokens (SKILL.md is roughly 4.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Zentty CLI?

Skills that share tags, products or a category with Zentty CLI: NotebookLM Research Assistant (PleasePrompto/notebooklm-skill, 7.8k stars), Brand and Design Toolkit (nextlevelbuilder/ui-ux-pro-max-skill, 134k stars), AI Image Generation and Editing (zhayujie/CowAgent, 47k stars) and ModLens Image Vision Bridge (liustack/modlens, 4.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Zentty CLI?

dedene (a GitHub user) maintains it in dedene/zentty, which has 310 GitHub stars. The repository was last updated on October 7, 2026.

Source: dedene/zentty on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Zentty CLI

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Zentty CLI

Detect Zentty

Operating Rules

Discovery

Layout And Pane Control

Launch Agents Through Zentty

Notify The User

Manual Hook Installs

Files

Compare with similar skills

Similar skills

NotebookLM Research Assistant

Brand and Design Toolkit

AI Image Generation and Editing

ModLens Image Vision Bridge

OpenCLI Smart Search Router

NotebookLM Automation

Related

Questions about Zentty CLI