Opens a new terminal window and creates a tracked terminal session. Returns a terminal ID that can be used with other commands.

Reads text output from a terminal session. Returns the current screen contents. Use mcpretentious-screenshot for rich terminal info including colors, cursor position, and styles.

Takes a token-optimized screenshot of the terminal screen using a layered format that reduces token usage by 85-98%. Returns only the data layers you need (text, cursor, colors, styles). Supports viewport limiting to show just a region or area around cursor. Essential for inspecting TUI applications without hitting token limits.

Closes the terminal window associated with the specified terminal ID.

Lists all currently open terminal sessions with their IDs.

Send text and keystrokes to a terminal. Always pass as array.

Examples: ["ls -la"], ["cd /path", {"key": "enter"}], ["Hello", 32, "World"], [{"key": "ctrl-c"}]

Supported keys: tab, shift-tab, enter, return, escape, esc, backspace, delete, up, down, right, left, home, end, pageup, pagedown, ctrl-a, ctrl-b, ctrl-c, ctrl-d, ctrl-e, ctrl-f, ctrl-g, ctrl-h, ctrl-i, ctrl-j, ctrl-k, ctrl-l, ctrl-m, ctrl-n, ctrl-o, ctrl-p, ctrl-q, ctrl-r, ctrl-s, ctrl-t, ctrl-u, ctrl-v, ctrl-w, ctrl-x, ctrl-y, ctrl-z, f1, f2, f3, f4, f5, f6, f7, f8, f9, f10, f11, f12, alt-a, alt-b, alt-c, alt-d, alt-e, alt-f, alt-g, alt-h, alt-i, alt-j, alt-k, alt-l, alt-m, alt-n, alt-o, alt-p, alt-q, alt-r, alt-s, alt-t, alt-u, alt-v, alt-w, alt-x, alt-y, alt-z, alt-shift-a, alt-shift-b, alt-shift-c, alt-shift-d, alt-shift-e, alt-shift-f, alt-shift-g, alt-shift-h, alt-shift-i, alt-shift-j, alt-shift-k, alt-shift-l, alt-shift-m, alt-shift-n, alt-shift-o, alt-shift-p, alt-shift-q, alt-shift-r, alt-shift-s, alt-shift-t, alt-shift-u, alt-shift-v, alt-shift-w, alt-shift-x, alt-shift-y, alt-shift-z, alt-0, alt-1, alt-2, alt-3, alt-4, alt-5, alt-6, alt-7, alt-8, alt-9, alt-tab, alt-enter, alt-space, alt-backspace, alt-left, alt-right, alt-up, alt-down, alt-home, alt-end, alt-pageup, alt-pagedown, alt-f1, alt-f2, alt-f3, alt-f4, alt-f5, alt-f6, alt-f7, alt-f8, alt-f9, alt-f10, alt-f11, alt-f12

Gets terminal metadata including dimensions (columns × rows) and session information.

Resizes a terminal to the specified dimensions in columns × rows.

Send mouse events to a terminal using SGR mouse protocol.

This tool provides direct control over mouse events following the terminal's SGR (Select Graphic Rendition) mouse protocol.

EVENTS:
- 'press': Mouse button press event
- 'release': Mouse button release event  
- 'drag': Mouse movement with button held down

BUTTONS (use names or button-N format):
Named buttons:
- 'left': Left mouse button
- 'middle': Middle mouse button
- 'right': Right mouse button
- 'scrollUp': Scroll wheel up
- 'scrollDown': Scroll wheel down

Direct button codes:
- 'button-0' through 'button-127': Direct SGR button codes
- Common codes: 0=left, 1=middle, 2=right, 64=scrollUp, 65=scrollDown

MODIFIERS (optional, default to false):
- shift: Hold shift key during event
- alt: Hold alt/option key during event
- ctrl: Hold control key during event

COORDINATES:
- x and y are 0-based character positions (column, row)
- The protocol will convert to 1-based coordinates internally

EXAMPLES:
- Left click at (10,5): event='press', button='left', x=10, y=5, then event='release' with same coordinates
- Drag from (5,5) to (15,10): event='press' at (5,5), event='drag' at (15,10), event='release' at (15,10)
- Scroll up at (20,8): event='press', button='scrollUp', x=20, y=8 (no release needed for scroll)