convez.ai
MCP ServerDevOps & InfraestruturaAvançado
xinjiyuan97

TerminalX

xinjiyuan97/terminalx

Terminal colaborativo humano + IA com MCP integrado

Ver no GitHub
InicialPluginScore · de 0 a 100

Gerenciador de sessões de terminal estilo tmux com suporte nativo a MCP para colaboração entre humanos e agentes IA. Fornece contexto compartilhado de terminal através de CLI, TUI e MCP, permitindo que pessoas e agentes operem simultaneamente nos mesmos painéis e sessões.

Instalação

$npx convez-ai xinjiyuan97/terminalx

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
3
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Colaboração entre agentes IA e usuários em sessões de terminal compartilhadas
  • Gerenciamento de múltiplos painéis de terminal sincronizados com operações de IA
  • Automação e execução de comandos através de MCP enquanto mantém contexto interativo

Veredito

TerminalX resolve um nicho real: colaboração human-in-the-loop com agentes IA em ambientes de terminal. Implementação sólida em Rust com MCP nativo, porém adequado principalmente para desenvolvedores confortáveis com gerenciamento de processos e interop em nível de sistema.

README

A tradução para o português deste README ainda está na fila.

terminalx

中文文档

A Rust-based, tmux-like terminal session manager for human + AI agent collaboration. It provides a shared terminal context across CLI, TUI, and MCP so both people and agents can operate on the same sessions/panels.

Features

  • Shared terminal context for human + agent workflows (CLI/TUI/MCP interop)
  • Background daemon with Unix socket IPC
  • PTY-backed panels (interactive program support)
  • Multi-panel sessions
  • Panel create/list/switch
  • Interactive attach with keyboard passthrough
  • tmux-style attach keybindings: Ctrl+B + c/n/p/w/d
  • Bottom attach status bar (ATTACHED, session/panel, time, shortcuts)
  • Terminal UI (ui) for panel navigation, switching, creation, and attach
  • Panel aliases
  • panel-list includes alias + last command preview (auto-truncated)
  • Panel signal controls (panel-interrupt, panel-signal)
  • Built-in MCP server via terminalx mcp-server (official rmcp SDK)

Commands

terminalx daemon
terminalx mcp-server
terminalx new <session> [--cmd "..."]
terminalx list

terminalx panel-new <session> [--name panel-name] [--alias "worker"] [--cmd "..."]
terminalx panel-alias <session> <panel> <alias>
terminalx panel-list <session>
terminalx panel-switch <session> <panel>
terminalx panel-interrupt <session> <panel>
terminalx panel-signal <session> <panel> <signal>

terminalx send <session> [--panel <panel>] <command...>
terminalx attach <session> [--panel <panel>] [--lines N]
terminalx ui <session>

terminalx kill <session>
terminalx stop

Quick Start

cargo run -- new dev
cargo run -- panel-new dev --alias worker
cargo run -- panel-switch dev 2
cargo run -- send dev --panel 2 "echo hello panel2"
cargo run -- attach dev --panel 2
# detach in attach mode: Ctrl+B then D

UI Keys

q: quit
j/k or arrow keys: select panel
s: switch active panel
c: create panel and switch to it
n/p: next/previous panel
w: show panel summary
Enter or a: attach selected panel

Attach Keys

Ctrl+B then:
c: create panel and switch attach
n: next panel
p: previous panel
w: print panel list
d: detach

Notes

  • send targets active panel by default; you can specify --panel
  • In non-TTY environments (pipe/CI), attach works in follow-only mode
  • panel-interrupt sends SIGINT
  • panel-signal supports names or numbers (e.g. SIGTERM, TERM, 15)

MCP Server

Built into the main binary and started with:

terminalx mcp-server

Exposed tools:

  • terminalx_list_panels
  • terminalx_view_panel
  • terminalx_exec_command
  • terminalx_signal_panel

Install to local bin

cargo build --release
install -m 755 target/release/terminalx /usr/local/bin/terminalx

Verify:

which terminalx
terminalx --help

MCP Config Example

{
  "mcpServers": {
    "terminalx": {
      "command": "/usr/local/bin/terminalx",
      "args": ["mcp-server"]
    }
  }
}

MCP Tool Inputs

  1. terminalx_list_panels
{ "session": "dev" }
  1. terminalx_view_panel
{ "session": "dev", "panel": "1", "lines": 120 }
  1. terminalx_exec_command
{ "session": "dev", "panel": "1", "command": "echo hello" }

Optional sync wait:

{
  "session": "dev",
  "command": "make test",
  "wait_for_completion": true,
  "timeout_secs": 30
}
  • timeout_secs is optional; omit it for no timeout.

Async mode:

{
  "session": "dev",
  "panel": "1",
  "command": "python job.py",
  "async": true,
  "callback_token": "job-42"
}

Async mode returns task_id immediately and sends completion notification:

{
  "method": "terminalx/task_finished",
  "params": {
    "task_id": "...",
    "session": "dev",
    "panel": "1",
    "conclusion": "success|failed",
    "exit_code": 0,
    "callback_token": "job-42"
  }
}
  1. terminalx_signal_panel
{ "session": "dev", "panel": "main", "signal": "SIGINT" }
  • signal is optional (default SIGINT)
Ver o original no GitHub

Bom para

Relacionados