# rename_session

Source: https://libtmux.org/en/csharp/latest/mcp/tools/rename_session/

> Change tmux state; no client-supplied executable input. Rename a tmux session. Its id does not change, so anything holding one still works.

MCP is in development

Server behavior and tool contracts may change. Tool availability depends on the server configuration.

Change tmux state; no client-supplied executable input. Rename a tmux session. Its id does not change, so anything holding one still works.

[All C# tools](https://libtmux.org/en/csharp/latest/mcp/tools/) · [JSON](https://libtmux.org/en/csharp/latest/mcp/tools/rename_session.json) · [Source](https://github.com/libtmux/libtmux-dotnet/blob/cf34b255c896d19a97e7d7fabea58609c916012d/src/LibTmux.Mcp/Policy/CapabilityModel.cs#L588)

## Arguments

* `name` required · string

  The new session name.

* `session` optional · string | null

  A session id or name. Omit for the first session.

  Default: `null`.

## Schemas

The schema defines required fields, nested values, defaults, and validation constraints.

Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "name": {
      "description": "The new session name.",
      "type": "string"
    },
    "session": {
      "default": null,
      "description": "A session id or name. Omit for the first session.",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "name"
  ],
  "type": "object"
}
```

Output schema

```json
{
  "properties": {
    "changed": {
      "type": "string"
    },
    "paneId": {
      "default": null,
      "type": [
        "string",
        "null"
      ]
    },
    "sessionId": {
      "default": null,
      "type": [
        "string",
        "null"
      ]
    },
    "windowId": {
      "default": null,
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "changed"
  ],
  "type": "object"
}
```

Tool annotations

```json
{
  "destructiveHint": true,
  "idempotentHint": false,
  "openWorldHint": true,
  "readOnlyHint": false,
  "title": "Rename session"
}
```