Agent skill

Pilotty

Automates terminal TUI applications (vim, htop, lazygit, dialog) through managed PTY sessions.

No licenceAuto-check passed

Install Pilotty

skills CLI

$ npx skills add msmps/pilotty --skill pilotty -a claude-code

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

GitHub CLI

$ gh skill install msmps/pilotty pilotty --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/msmps/pilotty.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/pilotty .claude/skills/pilotty && 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 "pilotty" agent skill from https://github.com/msmps/pilotty/tree/main/skills/pilotty into .claude/skills/pilotty/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "pilotty", 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/msmps/pilotty/tree/main/skills/pilotty

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 msmps/pilotty --skill pilotty -a codex

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

GitHub CLI

$ gh skill install msmps/pilotty pilotty --agent codex

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

Manual copy

$ git clone --depth 1 https://github.com/msmps/pilotty.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/pilotty .agents/skills/pilotty && 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 "pilotty" agent skill from https://github.com/msmps/pilotty/tree/main/skills/pilotty into .agents/skills/pilotty/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "pilotty", 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 msmps/pilotty --skill pilotty -a cursor

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

GitHub CLI

$ gh skill install msmps/pilotty pilotty --agent cursor

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

Manual copy

$ git clone --depth 1 https://github.com/msmps/pilotty.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/pilotty .cursor/skills/pilotty && 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 "pilotty" agent skill from https://github.com/msmps/pilotty/tree/main/skills/pilotty into .cursor/skills/pilotty/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "pilotty", 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/msmps/pilotty.git --path skills/pilotty

--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 msmps/pilotty --skill pilotty -a gemini-cli

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

GitHub CLI

$ gh skill install msmps/pilotty pilotty --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/msmps/pilotty.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/pilotty .gemini/skills/pilotty && 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 "pilotty" agent skill from https://github.com/msmps/pilotty/tree/main/skills/pilotty into .gemini/skills/pilotty/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "pilotty", 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 msmps/pilotty pilotty

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 msmps/pilotty --skill pilotty -a github-copilot

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

Manual copy

$ git clone --depth 1 https://github.com/msmps/pilotty.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/pilotty .github/skills/pilotty && 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 "pilotty" agent skill from https://github.com/msmps/pilotty/tree/main/skills/pilotty into .github/skills/pilotty/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "pilotty", 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 msmps/pilotty --skill pilotty -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 msmps/pilotty pilotty --agent opencode

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

Manual copy

$ git clone --depth 1 https://github.com/msmps/pilotty.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/pilotty .opencode/skills/pilotty && 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 "pilotty" agent skill from https://github.com/msmps/pilotty/tree/main/skills/pilotty into .opencode/skills/pilotty/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "pilotty", 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: pilotty
GitHub stars: 157
Token cost: ~4.6k tokens
SKILL.md length: 893 words
Files: 6 (incl. references)
Skills in repo: 1
Repo updated: Jul 11, 2026
First seen: Oct 7, 2026
Licence: None found

At a glance

Automates terminal TUI applications (vim, htop, lazygit, dialog) through managed PTY sessions.

Works in 6 steps: Spawn: pilotty spawn starts the app in a… → Wait: pilotty wait-for ensures the app… → Snapshot: pilotty snapshot returns the… → …
The user needs to interact with terminal apps
SKILL.md covers CRITICAL: Argument Positioning, Quick start, Core workflow and Commands, plus 12 more sections
Runs Shell scripts from its folder; calls jq

What it does

Pilotty is an agent skill from msmps/pilotty. Automates terminal TUI applications (vim, htop, lazygit, dialog) through managed PTY sessions. Use when the user needs to interact with terminal apps, edit files in vim/nano, navigate TUI menus, click terminal buttons/checkboxes, or automate CLI workflows with interactive prompts.

Its SKILL.md is about 4.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 7 other files, including reference files (for example `references/key-input.md`, `references/session-management.md` and `templates/dialog-interaction.sh`).

The repository describes itself as: Daemon-managed PTY sessions for AI agents to interact with terminal applications.

When your agent uses it

The user needs to interact with terminal apps
Edit files in vim/nano
Navigate TUI menus
Click terminal buttons/checkboxes

Example prompts

“Use the pilotty skill to automate terminal TUI applications (vim, htop, lazygit, dialog) through managed PTY sessions”
“/pilotty”

Requirements

A Bash shell
Pre-approved tools (allowed-tools): Bash(pilotty:*)

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

Spawn: pilotty spawn starts the app in a background PTY
Wait: pilotty wait-for ensures the app is ready
Snapshot: pilotty snapshot returns the current screen state
Understand: Read the screen text and cursor position
Interact: Use keyboard commands (key, type) or coordinate clicks
Re-snapshot: Check content_hash to observe screen changes

What it can do on your machine

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

Tool permissions
Pre-approves these tools, so the agent can use them without asking each time:
- Bash(pilotty:*)
From allowed-tools in the SKILL.md frontmatter.
Runs code
Ships script files (Shell), which the agent can run.
Shell commands in SKILL.md call:
- jq
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 no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Pilotty loads about 4.6k tokens when it runs, and up to ~8.1k if it reads all its reference files. Until then it costs about 72 tokens; SKILL.md has 893 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~72
When it runs · the whole SKILL.md, loaded when a task matches: ~4.6k
With references · SKILL.md plus every file in references/, read only if the agent opens them: ~8.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

Without a licence we can't republish the file, so here is its outline and opening line. It has 893 words (~4,578 tokens).

“All flags (--name, -s, --format, etc.) MUST come BEFORE positional arguments:”

— opening of SKILL.md by msmps

name: pilotty
allowed-tools: Bash(pilotty:*)

Outline of SKILL.md

Terminal Automation with pilotty
CRITICAL: Argument Positioning
Quick start
Core workflow
Commands
Session management
Screen capture
Retained output
Input
Interaction
Terminal control
Global options
Environment variables
Snapshot Output
Wait for Screen Changes (Recommended)
Waiting for Streaming AI Responses
Manual Change Detection
Navigation Approach
Example: Edit file with vim
Example: Dialog checklist interaction
Example: Form filling
Example: Monitor with htop
Example: Interact with AI TUI (opencode, etc.)
Sessions
Daemon Architecture
Error Handling
Common Patterns
Reliable action + wait (recommended)
Wait then act
Check state before action

Read the full SKILL.md on GitHub

Files

SKILL.md and 5 other files (references) in skills/pilotty of msmps/pilotty.

SKILL.md
references/key-input.md
references/session-management.md
templates/dialog-interaction.sh
templates/multi-session.sh
templates/vim-workflow.sh

Open the folder on GitHubat commit c53722b

Compare with similar skills

Pilotty 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.

Pilotty compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Pilotty this skillmsmps/pilotty	157	—	~4.6k	Automated safety check: Pass	None	2 mo ago
Autom AutomationComposioHQ/awesome-claude-skills	77k	3 repos	~723	Automated safety check: Pass	None	21 days ago
Doppler Marketing Automation AutomationComposioHQ/awesome-claude-skills	77k	3 repos	~809	Automated safety check: Pass	None	21 days ago
Suggest Automationsn8n-io/n8n	207k	—	~2k	Automated safety check: Pass	Custom licence	today
Aero Workflow AutomationComposioHQ/awesome-claude-skills	77k	3 repos	~753	Automated safety check: Pass	None	21 days ago
Anchor Browser AutomationComposioHQ/awesome-claude-skills	77k	3 repos	~757	Automated safety check: Pass	None	21 days ago

Similar skills

Autom Automation
ComposioHQ/awesome-claude-skills
Automate Autom tasks via Rube MCP (Composio). An agent skill from ComposioHQ/awesome-claude-skills.
77k GitHub starsUsed in 3 repos~723 tokens
Productivity & AutomationAuto-check passed
Doppler Marketing Automation Automation
ComposioHQ/awesome-claude-skills
Automate Doppler Marketing Automation tasks via Rube MCP (Composio).
77k GitHub starsUsed in 3 repos~809 tokens
Productivity & AutomationAuto-check passed
Suggest Automations
n8n-io/n8n
Official
Offer the three most common automations for a user as a single-choice card, from your own knowledge of their team and their apps, then build the one they choose once they confirm, or offer more.
207k GitHub stars~2k tokensUpdated today
Productivity & AutomationAuto-check passed
Aero Workflow Automation
ComposioHQ/awesome-claude-skills
Automate Aero Workflow tasks via Rube MCP (Composio). An agent skill from ComposioHQ/awesome-claude-skills.
77k GitHub starsUsed in 3 repos~753 tokens
Productivity & AutomationAuto-check passed
Anchor Browser Automation
ComposioHQ/awesome-claude-skills
Automate Anchor Browser tasks via Rube MCP (Composio). An agent skill from ComposioHQ/awesome-claude-skills.
77k GitHub starsUsed in 3 repos~757 tokens
Productivity & AutomationAuto-check passed
Automate This
github/awesome-copilot
Official
Analyze a screen recording of a manual process and produce targeted, working automation scripts.
40k GitHub starsUsed in 1 repo~3.1k tokens
Media & CreativeAuto-check passed

Questions about Pilotty

What does Pilotty do?

Automates terminal TUI applications (vim, htop, lazygit, dialog) through managed PTY sessions. Pilotty is an agent skill from msmps/pilotty. Automates terminal TUI applications (vim, htop, lazygit, dialog) through managed PTY sessions.

When should I use Pilotty?

Pilotty fits situations like: the user needs to interact with terminal apps; edit files in vim/nano; navigate TUI menus; click terminal buttons/checkboxes.

How do I install Pilotty in Claude Code?

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

How do I install Pilotty in Codex?

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

Can I use Pilotty 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 msmps/pilotty --skill pilotty -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/pilotty, .gemini/skills/pilotty, .github/skills/pilotty and .opencode/skills/pilotty in your project.

What does Pilotty need to run?

Going by SKILL.md and its folder, Pilotty needs a shell for the scripts in its folder and the command-line tools its instructions call (jq). Our summary lists: A Bash shell. Its frontmatter pre-approves these tools: Bash(pilotty:*).

Does Pilotty 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 Pilotty 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 Pilotty use?

No licence was found for Pilotty or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Pilotty use?

About 4.6k tokens (SKILL.md is roughly 18k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 3.5k tokens, read only when the agent opens those files.

What are the alternatives to Pilotty?

Skills that share tags, products or a category with Pilotty: Autom Automation (ComposioHQ/awesome-claude-skills, 77k stars), Doppler Marketing Automation Automation (ComposioHQ/awesome-claude-skills, 77k stars), Suggest Automations (n8n-io/n8n, 207k stars) and Aero Workflow Automation (ComposioHQ/awesome-claude-skills, 77k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Pilotty?

msmps (a GitHub user) maintains it in msmps/pilotty, which has 157 GitHub stars. The repository was last updated on July 11, 2026.

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

Install Pilotty

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Files

Compare with similar skills

Similar skills

Autom Automation

Doppler Marketing Automation Automation

Suggest Automations

Aero Workflow Automation

Anchor Browser Automation

Automate This

Questions about Pilotty