Tmux MCP Server

Instructions

Implementation Reference

• src/index.ts:803-816 (handler)

  The asynchronous handler function for the tmux_rename_session tool. It executes the tmux rename-session command using the runTmux helper, handles errors, and returns a structured response with success status or error message.

    try {
      await runTmux(`rename-session -t "${old_name}" "${new_name}"`);
  
      return {
        content: [{ type: "text", text: `Session renamed from '${old_name}' to '${new_name}'.` }],
        structuredContent: { success: true, old_name, new_name },
      };
    } catch (error) {
      return {
        content: [{ type: "text", text: error instanceof Error ? error.message : String(error) }],
        isError: true,
      };
    }
  }

• src/index.ts:789-794 (schema)

  Zod input schema defining required string parameters old_name (current session name) and new_name (new session name) for the tmux_rename_session tool.

  inputSchema: z
    .object({
      old_name: z.string().min(1).describe("Current session name"),
      new_name: z.string().min(1).describe("New session name"),
    })
    .strict(),

• src/index.ts:780-817 (registration)

  Registration of the tmux_rename_session tool on the MCP server, including tool name, metadata (title, description, annotations), input schema, and inline handler function.

  server.registerTool(
    "tmux_rename_session",
    {
      title: "Rename tmux Session",
      description: `Rename an existing tmux session.
  
  Args:
    - old_name (string, required): Current session name
    - new_name (string, required): New session name`,
      inputSchema: z
        .object({
          old_name: z.string().min(1).describe("Current session name"),
          new_name: z.string().min(1).describe("New session name"),
        })
        .strict(),
      annotations: {
        readOnlyHint: false,
        destructiveHint: false,
        idempotentHint: true,
        openWorldHint: false,
      },
    },
    async ({ old_name, new_name }) => {
      try {
        await runTmux(`rename-session -t "${old_name}" "${new_name}"`);
  
        return {
          content: [{ type: "text", text: `Session renamed from '${old_name}' to '${new_name}'.` }],
          structuredContent: { success: true, old_name, new_name },
        };
      } catch (error) {
        return {
          content: [{ type: "text", text: error instanceof Error ? error.message : String(error) }],
          isError: true,
        };
      }
    }
  );