@arearseth/tmux-mcp 0.2.2 → 0.3.0

package/README.md

@@ -7,7 +7,7 @@ Model Context Protocol server that enables Claude Desktop to interact with and v
 - List and search tmux sessions
 - View and navigate tmux windows and panes
 - Capture and expose terminal content from any pane
-- Execute commands in tmux panes and retrieve results (use it at your own risk ⚠️)
+- Execute commands in tmux panes and retrieve results across bash, zsh, fish, and tclsh shells (use it at your own risk ⚠️)
 - Create new tmux sessions and windows
 - Split panes horizontally or vertically with customizable sizes
 - Kill tmux sessions, windows, and panes
@@ -40,7 +40,7 @@ Add this MCP server to your Claude Desktop configuration:
 
 ### MCP server options
 
-You can optionally specify the command line shell you are using, if unspecified it defaults to `bash`
+You can optionally specify the default shell the server should assume when wrapping commands. If unspecified it defaults to `bash`.
 
 ```json
 "mcpServers": {
@@ -51,7 +51,7 @@ You can optionally specify the command line shell you are using, if unspecified
 }
 ```
 
-The MCP server needs to know the shell only when executing commands, to properly read its exit status.
+The CLI flag only sets the server-wide default. You can still override individual panes (or change the default at runtime) with the `set-shell-type` tool described below. The MCP server needs to know the shell when executing commands so it can wrap and read exit statuses correctly.
 
 ## Available Resources
 
@@ -72,6 +72,6 @@ The MCP server needs to know the shell only when executing commands, to properly
 - `kill-session` - Kill a tmux session by ID
 - `kill-window` - Kill a tmux window by ID
 - `kill-pane` - Kill a tmux pane by ID
+- `set-shell-type` - Configure the shell used for command execution (supports bash, zsh, fish, tclsh). Provide a paneId to override a single pane, or omit to adjust the default.
 - `execute-command` - Execute a command in a tmux pane
 - `get-command-result` - Get the result of an executed command
-

package/build/index.js

@@ -112,16 +112,30 @@ server.tool("list-panes", "List panes in a tmux window", {
     }
 });
 // Capture pane content - Tool
-server.tool("capture-pane", "Capture content from a tmux pane with configurable lines count and optional color preservation", {
+server.tool("capture-pane", "Capture content from a tmux pane. Defaults to the last N lines, but you can provide tmux-style start/end offsets (like 0 and -) to walk the full scrollback.", {
     paneId: z.string().describe("ID of the tmux pane"),
-    lines: z.string().optional().describe("Number of lines to capture"),
+    lines: z.string().optional().describe("Number of trailing lines to capture when start/end offsets are omitted (defaults to 200)"),
+    start: z.string().optional().describe("tmux -S offset; use 0 for the oldest line or a negative value to offset from the bottom"),
+    end: z.string().optional().describe("tmux -E offset; use - for the newest line or 0 for the active cursor line"),
     colors: z.boolean().optional().describe("Include color/escape sequences for text and background attributes in output")
-}, async ({ paneId, lines, colors }) => {
+}, async ({ paneId, lines, start, end, colors }) => {
     try {
         // Parse lines parameter if provided
-        const linesCount = lines ? parseInt(lines, 10) : undefined;
-        const includeColors = colors || false;
-        const content = await tmux.capturePaneContent(paneId, linesCount, includeColors);
+        const parsedLines = lines !== undefined ? parseInt(lines, 10) : undefined;
+        const includeColors = colors ?? false;
+        const options = {
+            includeColors
+        };
+        if (parsedLines !== undefined && !Number.isNaN(parsedLines) && parsedLines > 0) {
+            options.lines = parsedLines;
+        }
+        if (start !== undefined && start !== '') {
+            options.start = start;
+        }
+        if (end !== undefined && end !== '') {
+            options.end = end;
+        }
+        const content = await tmux.capturePaneContent(paneId, options);
         return {
             content: [{
                     type: "text",
@@ -287,7 +301,7 @@ server.tool("split-pane", "Split a tmux pane horizontally or vertically", {
     }
 });
 // Configure shell type - Tool
-server.tool("set-shell-type", "Configure the shell type used for command execution. Provide paneId to override a specific pane.", {
+server.tool("set-shell-type", "Configure the shell for command execution (bash, zsh, fish, tclsh). Provide paneId to override a specific pane.", {
     type: shellTypeSchema,
     paneId: z.string().optional().describe("ID of the tmux pane to override. Omit to change the default shell type.")
 }, async ({ type, paneId }) => {
@@ -461,7 +475,10 @@ server.resource("Tmux Pane Content", new ResourceTemplate("tmux://pane/{paneId}"
         // Ensure paneId is a string
         const paneIdStr = Array.isArray(paneId) ? paneId[0] : paneId;
         // Default to no colors for resources to maintain clean programmatic access
-        const content = await tmux.capturePaneContent(paneIdStr, 200, false);
+        const content = await tmux.capturePaneContent(paneIdStr, {
+            lines: 200,
+            includeColors: false
+        });
         return {
             contents: [{
                     uri: uri.href,

package/build/tmux.js

@@ -2,7 +2,7 @@ import { exec as execCallback } from "child_process";
 import { promisify } from "util";
 import { v4 as uuidv4 } from 'uuid';
 const exec = promisify(execCallback);
-export const supportedShellTypes = ['bash', 'zsh', 'fish', 'fc_shell'];
+export const supportedShellTypes = ['bash', 'zsh', 'fish', 'tclsh'];
 const shellConfig = {
     defaultType: 'bash',
     paneOverrides: new Map()
@@ -17,12 +17,12 @@ export function setShellConfig(config) {
     if (config.paneId) {
         shellConfig.paneOverrides.set(config.paneId, normalized);
         // Reset cached initialization so the helper can be installed on demand
-        fcShellInitializedPanes.delete(config.paneId);
+        tclshInitializedPanes.delete(config.paneId);
         return;
     }
     shellConfig.defaultType = normalized;
-    if (normalized !== 'fc_shell') {
-        fcShellInitializedPanes.clear();
+    if (normalized !== 'tclsh') {
+        tclshInitializedPanes.clear();
     }
 }
 function resolveShellType(paneId) {
@@ -121,9 +121,16 @@ export async function listPanes(windowId) {
 /**
  * Capture content from a specific pane, by default the latest 200 lines.
  */
-export async function capturePaneContent(paneId, lines = 200, includeColors = false) {
-    const colorFlag = includeColors ? '-e' : '';
-    return executeTmux(`capture-pane -p ${colorFlag} -t '${paneId}' -S -${lines} -E -`);
+export async function capturePaneContent(paneId, options = {}) {
+    const { lines = 200, start, end, includeColors = false } = options;
+    const startValue = start !== undefined ? String(start) : `-${lines}`;
+    const endValue = end !== undefined ? String(end) : '-';
+    const commandParts = ['capture-pane', '-p'];
+    if (includeColors) {
+        commandParts.push('-e');
+    }
+    commandParts.push('-t', `'${paneId}'`, '-S', startValue, '-E', endValue);
+    return executeTmux(commandParts.join(' '));
 }
 /**
  * Create a new tmux session
@@ -190,8 +197,8 @@ export async function splitPane(targetPaneId, direction = 'vertical', size) {
 const activeCommands = new Map();
 const startMarkerText = 'TMUX_MCP_START';
 const endMarkerPrefix = "TMUX_MCP_DONE_";
-// Track fc_shell initialization per pane to keep terminal output minimal
-const fcShellInitializedPanes = new Set();
+// Track tclsh initialization per pane to keep terminal output minimal
+const tclshInitializedPanes = new Set();
 // Execute a command in a tmux pane and track its execution
 export async function executeCommand(paneId, command, rawMode, noEnter) {
     // Generate unique ID for this command execution
@@ -202,9 +209,9 @@ export async function executeCommand(paneId, command, rawMode, noEnter) {
         fullCommand = command;
     }
     else {
-        if (shellType === 'fc_shell') {
-            await ensureFcShellInitialized(paneId);
-            fullCommand = buildFcShellCommand(command);
+        if (shellType === 'tclsh') {
+            await ensureTclshInitialized(paneId);
+            fullCommand = buildTclshCommand(command);
         }
         else {
             fullCommand = buildWrappedCommand(command, shellType);
@@ -249,7 +256,7 @@ export async function checkCommandStatus(commandId) {
         return null;
     if (command.status !== 'pending')
         return command;
-    const content = await capturePaneContent(command.paneId, 1000);
+    const content = await capturePaneContent(command.paneId, { lines: 1000 });
     if (command.rawMode) {
         command.result = 'Status tracking unavailable for rawMode commands. Use capture-pane to monitor interactive apps instead.';
         return command;
@@ -307,7 +314,7 @@ function getEndMarkerText(shellType) {
     if (shellType === 'fish') {
         return `${endMarkerPrefix}$status`;
     }
-    if (shellType === 'fc_shell') {
+    if (shellType === 'tclsh') {
         return `${endMarkerPrefix}$::tmux_mcp_status`;
     }
     return `${endMarkerPrefix}$?`;
@@ -316,7 +323,7 @@ function buildWrappedCommand(command, shellType) {
     const endMarkerText = getEndMarkerText(shellType);
     return `echo "${startMarkerText}"; ${command}; echo "${endMarkerText}"`;
 }
-function buildFcShellCommand(command) {
+function buildTclshCommand(command) {
     const escaped = escapeForTcl(command);
     return `::tmux_mcp::run {${escaped}}`;
 }
@@ -328,8 +335,8 @@ function escapeForTcl(command) {
         .replace(/\{/g, '\\{')
         .replace(/\}/g, '\\}');
 }
-async function ensureFcShellInitialized(paneId) {
-    if (fcShellInitializedPanes.has(paneId)) {
+async function ensureTclshInitialized(paneId) {
+    if (tclshInitializedPanes.has(paneId)) {
         return;
     }
     const definitionCommand = [
@@ -348,5 +355,5 @@ async function ensureFcShellInitialized(paneId) {
     ].join(' ');
     const escapedCommand = definitionCommand.replace(/'/g, "'\\''");
     await executeTmux(`send-keys -t '${paneId}' '${escapedCommand}' Enter`);
-    fcShellInitializedPanes.add(paneId);
+    tclshInitializedPanes.add(paneId);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arearseth/tmux-mcp",
-  "version": "0.2.2",
+  "version": "0.3.0",
   "description": "MCP Server for interfacing with tmux sessions",
   "type": "module",
   "main": "build/index.js",