terminal - Shell Command Execution

Core Concept

mcp__plugin_kg_kodegen__terminal executes shell commands in persistent VT100 terminal sessions. Terminals maintain environment variables, working directory, and shell state across commands. Use different terminal numbers for parallel work.

Actions

Key Parameters

Usage Examples

Execute Command (default action)

{ "command": "ls -la" }

Execute in Specific Terminal

{ "terminal": 1, "command": "cargo build --release" }

Background Execution (fire-and-forget)

{
  "command": "npm run build",
  "await_completion_ms": 0
}

Execute with Timeout

{
  "command": "cargo test",
  "await_completion_ms": 60000
}

Read Current Buffer

{ "action": "READ", "terminal": 0 }

List All Terminals

{ "action": "LIST" }

Kill Terminal

{ "action": "KILL", "terminal": 0 }

Response Format

{
  "terminal": 0,
  "exit_code": 0,
  "cwd": "/project/path",
  "duration_ms": 1234,
  "completed": true
}

Parallel Work Pattern

Use different terminal numbers for concurrent tasks:

// Terminal 0: Build
{ "terminal": 0, "command": "cargo build" }

// Terminal 1: Tests (parallel)
{ "terminal": 1, "command": "cargo test" }

// Terminal 2: Watch logs
{ "terminal": 2, "command": "tail -f app.log" }

Background Execution

For long-running commands:

1. Fire-and-forget: await_completion_ms: 0
2. Check progress: { "action": "READ", "terminal": N }
3. Wait with timeout: If timeout occurs, command continues in background

Important Notes

• Persistent sessions: Environment and working directory preserved
• VT100 emulation: Actual rendered terminal output, not raw bytes
• Automatic cleanup: Terminals cleaned up on connection close
• State preservation: cd commands persist across calls

Remember

• Terminals are numbered 0, 1, 2... - use different numbers for parallel work
• Default action is EXEC - just provide command
• Use await_completion_ms: 0 for background tasks
• Use action: "READ" to check on background commands
• Working directory persists - cd works across commands
• For simple file operations, prefer fs_* tools (faster, safer)