tmux-mcp-server logo

tmux-mcp-server

by Orad

This MCP server enables AI agents to interact with TMUX as a terminal session manager. It's valuable for auditing AI agent actions and managing multiple terminal sessions.

View on GitHub

Last updated: N/A

What is tmux-mcp-server?

This is an MCP (Message Control Protocol) server that allows AI agents to interact with and control TMUX terminal sessions.

How to use tmux-mcp-server?

The server uses a default session named 'agent-terminal', but AI agents can be instructed to use other sessions. The 'client' directory contains a test MCP client and pytests that can be run using './run-tests.sh'.

Key features of tmux-mcp-server

  • Auditing of AI agent actions

  • Session recording

  • Background operation

  • Support for multiple windows panes and tmux sessions

Use cases of tmux-mcp-server

  • Monitoring AI agent activity in terminals

  • Recording terminal sessions for analysis

  • Running AI agents in the background

  • Managing multiple terminal sessions for AI agents

FAQ from tmux-mcp-server

What is the default TMUX session used?

The default session is named 'agent-terminal'.

Can I use a different TMUX session?

Yes, you can instruct the AI agent to use a different session.

How can I test the server?

The 'client' directory contains a test MCP client and pytests. Run './run-tests.sh' to execute the tests.

What are the benefits of using this server?

It allows for auditing, session recording, background operation, and management of multiple terminal sessions for AI agents.

Where can I find example usage?

The 'client' directory contains a test MCP client that demonstrates basic usage.