Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
40 changes: 22 additions & 18 deletions .github/skills/doc-tester/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -658,33 +658,37 @@ mcp_playwright_browser_type # Type text
mcp_playwright_browser_screenshot # Capture screenshot
```

### Hex1b Terminal MCP Tools
### Hex1b CLI Tools

The Hex1b MCP server provides tools for interacting with terminal sessions and capturing terminal output. This is particularly useful for:
The Hex1b CLI tool provides terminal automation for interacting with terminal sessions and capturing terminal output. This is particularly useful for:

- **Capturing terminal screenshots** for documentation evidence
- **Recording asciinema sessions** (`.cast` files) for documentation
- **Recording terminal sessions** for documentation

#### Available Tools
#### Installation

First, activate the terminal tools you need:
Install Hex1b.Tool if not already available:

```
activate_terminal_session_creation_tools # Start bash/powershell sessions
activate_terminal_interaction_tools # Screenshots, text capture, input
```bash
dotnet tool install -g Hex1b.Tool
```

Then use the terminal tools:
Refer to the **hex1b skill** for the full command reference.

```
mcp_hex1b_list_terminals # List active terminal sessions
mcp_hex1b_start_bash_terminal # Start a new bash session
mcp_hex1b_start_pwsh_terminal # Start a new PowerShell session
mcp_hex1b_send_terminal_input # Send commands to terminal
mcp_hex1b_wait_for_terminal_text # Wait for specific output
mcp_hex1b_capture_terminal_screenshot # Capture terminal as SVG
mcp_hex1b_capture_terminal_text # Capture terminal text content
mcp_hex1b_record_asciinema # Record terminal session as .cast file
#### Common Commands

```bash
dotnet hex1b terminal list # List active terminal sessions
dotnet hex1b terminal start -- bash # Start a new bash session
dotnet hex1b terminal start -- pwsh # Start a new PowerShell session
dotnet hex1b keys <id> --text "command" # Send text to terminal
dotnet hex1b keys <id> --key Enter # Send a keypress
dotnet hex1b assert <id> --text-present "..." # Wait for specific output
dotnet hex1b capture screenshot <id> --format svg # Capture terminal as SVG
dotnet hex1b capture screenshot <id> --format text # Capture terminal text content
dotnet hex1b capture recording start <id> --output <file>.cast # Start asciinema recording
dotnet hex1b capture recording stop <id> # Stop asciinema recording
dotnet hex1b terminal stop <id> # Stop a terminal session
```

#### Asciinema Recordings
Expand Down
45 changes: 31 additions & 14 deletions .github/skills/doc-writer/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -524,28 +524,45 @@ import AsciinemaPlayer from '@components/AsciinemaPlayer.astro';
- `speed`: Playback speed multiplier (default: 1.5)
- `idleTimeLimit`: Max idle time between commands (default: 1.5s)

#### Creating New Recordings with Hex1b MCP
#### Creating New Recordings with Hex1b CLI

Use the Hex1b MCP server to create new terminal recordings:
Use the Hex1b CLI tool to create new terminal recordings and screenshots. Install it first if needed:

1. Activate the terminal tools:
```
activate_terminal_session_creation_tools
activate_terminal_interaction_tools
```bash
dotnet tool install -g Hex1b.Tool
```

Refer to the **hex1b skill** for the full command reference. Common workflow:

1. Start a terminal session:
```bash
dotnet hex1b terminal start -- bash
# Note the terminal ID from the output
```

2. Start a terminal session and record:
2. Send commands and wait for output:
```bash
dotnet hex1b keys <id> --text "aspire run"
dotnet hex1b keys <id> --key Enter
dotnet hex1b assert <id> --text-present "Ready" --timeout 30
```
mcp_hex1b_start_bash_terminal # Start a new session
mcp_hex1b_send_terminal_input # Send commands
mcp_hex1b_wait_for_terminal_text # Wait for output
mcp_hex1b_record_asciinema # Save as .cast file

3. Record a session:
```bash
dotnet hex1b capture recording start <id> --output session.cast
# ... interact with the terminal ...
dotnet hex1b capture recording stop <id>
```

3. For screenshots instead of recordings:
4. Capture output as SVG (for screenshots) or text:
```bash
dotnet hex1b capture screenshot <id> --format svg --output screenshot.svg
dotnet hex1b capture screenshot <id> --format text --output output.txt
```
mcp_hex1b_capture_terminal_screenshot # Capture as SVG
mcp_hex1b_capture_terminal_text # Capture as text

5. Stop the terminal when done:
```bash
dotnet hex1b terminal stop <id>
```

#### When to Use Recordings vs Code Blocks
Expand Down
Loading
Loading