Prepare the server locally
Run this once before adding it to Claude Code.
bun install
bun run compileRegister it in Claude Code
claude mcp add terminal-hook -- node /path/to/mcp-server.mjsReplace any placeholder paths in the command with the real path on your machine.
Make your agent remember this setup
terminal-hook's config, env vars, and the gotchas you hit — recalled in every future Claude Code, Cursor, and Codex session.
npx conare@latestFree · one command · indexes the sessions already on disk. Set up in the browser instead →
What it does
- Real-time capture of terminal output as it happens
- Automatic stripping of ANSI codes and shell noise
- MCP integration for AI assistant access
- Support for listing active terminal sessions and metadata
Tools 2
list_terminalsList all active terminals with metadata.get_terminal_outputGet output from a specific terminal.Try it
Original README from rodgomesc/terminal-hook
Terminal Hook
A VSCode/Cursor extension that captures terminal output in real-time and exposes it via MCP (Model Context Protocol) for AI assistants.
Why another extension?
copy-pasting terminal output and manually referencing it in every chat is so meehhh. When AI assistants can proactively read your terminal — checking errors, logs, and command output without you having to break the execution to ask for more info, this extension solves that! Other MCP tools can also tap into terminal data for automation
How It Works
┌─────────────────┐ stdio ┌─────────────────┐ TCP ┌─────────────────┐
│ Cursor/Claude │◄──────────────►│ mcp-server.mjs │◄────────────►│ VSCode Extension│
│ (MCP Client) │ │ (MCP Server) │ port 9876 │ (Terminal Data) │
└─────────────────┘ └─────────────────┘ └─────────────────┘
- VSCode Extension captures terminal output via
onDidWriteTerminalDataAPI - MCP Server (
mcp-server.mjs) communicates with Cursor via stdio - TCP Bridge connects the MCP server to the extension on port 9876
Features
- Real-time Capture - Captures all terminal output as it happens
- Clean Output - Automatically strips ANSI codes and shell noise
- MCP Integration - Exposes terminal data to AI assistants like Claude
Installation
See INSTALL.md for setup instructions.
MCP Tools
`list_terminals`
List all active terminals with metadata.
{
"success": true,
"count": 2,
"terminals": [
{
"id": "terminal-0-zsh",
"name": "zsh",
"processId": 1234,
"bufferLines": 150,
"lastActivity": "2024-12-18T10:30:00.000Z"
}
]
}
`get_terminal_output`
Get output from a specific terminal.
Parameters:
terminal_name(required): Terminal name or IDlines(optional): Number of lines to return (default: 100)
{
"success": true,
"terminal": "zsh",
"output": "$ npm start
Server running on port 3000
...",
"lines_returned": 50
}
Development
bun install
bun run compile
bun test
License
MIT