shell-use
OfficialControl real terminals, automate interactions, and assert results with shell-use CLI.
Authormicrosoft
Version1.0.0
Installs0
System Documentation
What problem does it solve?
This Skill enables the control and interaction with real terminal sessions, automating tasks, inspecting states, and verifying outputs. It streamlines repetitive terminal operations and enhances the efficiency of workflows involving shell sessions.
Core Features & Use Cases
- Shell Session Control: Spawn, inspect, and manage terminal sessions for various shells and TUI applications.
- Automated Interactions: Send keystrokes, mouse inputs, and signals to sessions for automated tasks.
- Verification: Assert expected text, colors, exit codes, and snapshots against session outputs.
- Recording & Monitoring: Record terminal sessions for later analysis and monitor sessions live from another terminal.
- Programmatic Access: Use Python or JavaScript libraries to drive the daemon and interact with terminal sessions programmatically.
- Use Case: Consider automating a complex sequence of shell commands and text interactions in a test or debugging scenario.
Quick Start
Open a new terminal session and use the shell-use skill to run a command, check the result, and close the session.
Dependency Matrix
Required Modules
alacritty_terminalanyhowclapdirsflate2interprocessportable-ptyregexserdeserde_jsoncrossterm
Components
scriptsreferencesassets
💻 Claude Code Installation
Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.
Please help me install this Skill: Name: shell-use Download link: https://github.com/microsoft/shell-use/archive/main.zip#shell-use Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
Agent Skills Search Helper
Install a tiny helper to your Agent, search and equip skill from 620,000+ vetted skills library on demand.