MCP App Store
by KeenEthics
Terminal Commands icon

Terminal Commands MCP Server for ChatGPT

By HAMDI KAHLOUN

Overview

Terminal Commands connects ChatGPT and compatible MCP clients to computers and servers you control. Choose a saved project, inspect files, edit bounded text files, run locally approved commands, and review command activity and source changes. Active commands return progress and completion through server tools without requiring the workspace card or chat page to remain open. Your computer and companion must remain running; local approvals and host usage limits still apply. The plugin cannot restart a Chat turn that the host has ended or cancelled. Dedicated filesystem tools stay within approved roots; approved executable programs run with your operating-system permissions and are not sandboxed. The gateway stores bounded process output and project source baselines, with a default seven-day retention period for output and baselines; task metadata remains longer to prevent accidental re-execution. Manage paired devices and tasks at https://mcp.terminalcommands.fr/.

How to connect

  1. ChatGPT: Open the Terminal Commands listing in the ChatGPT app directory and choose Connect. ChatGPT listing Terminal Commands exposes 30 tools here.

Tools

begin_cloud_codespace

ChatGPT
Before other Terminal Commands tools for a new request, call open_workspace once to show the inline Activity/Changes card. Reuse the conversationId and selected project returned by the previous request in this same conversation, even after it finished; only requestId changes. Continue the same request with its existing runId; submit_project_process and get_project_run show its Activity at the current step in the chat. App-only: after the user accepts the full-shell and billing warning in Workspace, issue a short-lived single-use GitHub authorization link.

cancel_process_task

ChatGPT
Before other Terminal Commands tools for a new request, call open_workspace once to show the inline Activity/Changes card. Reuse the conversationId and selected project returned by the previous request in this same conversation, even after it finished; only requestId changes. Continue the same request with its existing runId; submit_project_process and get_project_run show its Activity at the current step in the chat. Request cancellation for a process task. Before dispatch this cancels pending approval; for running processes it requests a locally approved termination. A result of cancelling or unknown is not proof that the process stopped.

cloud_codespace_status

ChatGPT
Before other Terminal Commands tools for a new request, call open_workspace once to show the inline Activity/Changes card. Reuse the conversationId and selected project returned by the previous request in this same conversation, even after it finished; only requestId changes. Continue the same request with its existing runId; submit_project_process and get_project_run show its Activity at the current step in the chat. App-only: read this signed-in user's current GitHub Codespaces setup progress for the Workspace card.

connect_workspace_view

ChatGPT
Before other Terminal Commands tools for a new request, call open_workspace once to show the inline Activity/Changes card. Reuse the conversationId and selected project returned by the previous request in this same conversation, even after it finished; only requestId changes. Continue the same request with its existing runId; submit_project_process and get_project_run show its Activity at the current step in the chat. App-only: record that this run's workspace view has mounted for diagnostics. Command execution and tool results do not depend on this view.

continue_project_request

ChatGPT
App-only: after the user explicitly chooses a project, create or recover its run and claim one automatic continuation. A false continuationGranted means the message was already reserved; never send it again automatically.

create_project_folder

ChatGPT
Device discovery and setup belong in the Workspace card. For any device list/status/selection or add/connect/manage local/cloud machine request, call open_workspace({goal:'Manage devices'}) exactly once to show machine states and setup, even when devices are connected. If list_devices returns no connected devices during any task, open the same card instead of giving only a text answer. Do not start a billable Codespace without explicit user consent. Quick completed commands and ordinary file reads with connected machines need no card. For pending/running/cancelling raw commands, call open_workspace({}) at most once for live Activity, then wait without additional cards. For a tracked saved-project request, open_workspace once with the original goal and requestId, preserving project and conversationId. When building a new supported app with Live App Preview, create and save the app before opening that one card. Never mount duplicate cards during progress checks or transcript history; commands and run reads return data directly. Create one new folder with the chosen name under an approved parent on the user's connected machine. Requires local approval. Returns the created path. If the folder exists, inspect it before choosing a different name or using it.

create_project_run

ChatGPT
Before other Terminal Commands tools for a new request, call open_workspace once to show the inline Activity/Changes card. Reuse the conversationId and selected project returned by the previous request in this same conversation, even after it finished; only requestId changes. Continue the same request with its existing runId; submit_project_process and get_project_run show its Activity at the current step in the chat. Start a coding run by capturing bounded source text as its baseline. Generate one runId and reuse it on retries. Existing local edits are part of the baseline. Source snapshots are retained on the gateway for seven days.

finish_project_request

ChatGPT
Before other Terminal Commands tools for a new request, call open_workspace once to show the inline Activity/Changes card. Reuse the conversationId and selected project returned by the previous request in this same conversation, even after it finished; only requestId changes. Continue the same request with its existing runId; submit_project_process and get_project_run show its Activity at the current step in the chat. Mark this request finished before your final reply, including read-only file work or a reported failure. This stops the inline preparation indicator; it does not assert success, execute or stop commands. Call only when you have finished handling the original request and no command is active or unconfirmed. Idempotent. A new user request needs a fresh requestId in open_workspace, keeping the selected project.

forget_project

ChatGPT
Before other Terminal Commands tools for a new request, call open_workspace once to show the inline Activity/Changes card. Reuse the conversationId and selected project returned by the previous request in this same conversation, even after it finished; only requestId changes. Continue the same request with its existing runId; submit_project_process and get_project_run show its Activity at the current step in the chat. Remove a saved project bookmark. Does not delete machine files.

forget_project_run

ChatGPT
Before other Terminal Commands tools for a new request, call open_workspace once to show the inline Activity/Changes card. Reuse the conversationId and selected project returned by the previous request in this same conversation, even after it finished; only requestId changes. Continue the same request with its existing runId; submit_project_process and get_project_run show its Activity at the current step in the chat. Delete a run's source baseline and references from the gateway. Does not stop commands or delete machine files. Retained process logs follow the dashboard retention policy.

get_process_task

ChatGPT
Before other Terminal Commands tools for a new request, call open_workspace once to show the inline Activity/Changes card. Reuse the conversationId and selected project returned by the previous request in this same conversation, even after it finished; only requestId changes. Continue the same request with its existing runId; submit_project_process and get_project_run show its Activity at the current step in the chat. Return the current state and bounded stdout/stderr of an asynchronous process task. The gateway can return unknown when a device disconnects or its execution outcome is uncertain.

get_project_changes

ChatGPT
Before other Terminal Commands tools for a new request, call open_workspace once to show the inline Activity/Changes card. Reuse the conversationId and selected project returned by the previous request in this same conversation, even after it finished; only requestId changes. Continue the same request with its existing runId; submit_project_process and get_project_run show its Activity at the current step in the chat. Compare bounded source text with the run baseline, not Git HEAD. Coverage omissions are explicit. Supply a path from changes to retrieve its before and after text for review.

get_project_run

ChatGPT
Before other Terminal Commands tools for a new request, call open_workspace once to show the inline Activity/Changes card. Reuse the conversationId and selected project returned by the previous request in this same conversation, even after it finished; only requestId changes. Continue the same request with its existing runId; submit_project_process and get_project_run show its Activity at the current step in the chat. Show this existing run's inline Activity/Changes card and recover retained command output without re-executing commands. Reuse its runId without creating a baseline. For an active command, wait_process_task returns progress and completion directly to the model without a loaded card.

get_system_info

ChatGPT
Before other Terminal Commands tools for a new request, call open_workspace once to show the inline Activity/Changes card. Reuse the conversationId and selected project returned by the previous request in this same conversation, even after it finished; only requestId changes. Continue the same request with its existing runId; submit_project_process and get_project_run show its Activity at the current step in the chat. Return basic information for a connected machine.

get_workspace_activity

ChatGPT
Before other Terminal Commands tools for a new request, call open_workspace once to show the inline Activity/Changes card. Reuse the conversationId and selected project returned by the previous request in this same conversation, even after it finished; only requestId changes. Continue the same request with its existing runId; submit_project_process and get_project_run show its Activity at the current step in the chat. App-only: follow the current request within this run's explicit conversation binding, or inspect an earlier request without changing the active goal. Never infer a conversation from the account's latest project run.

install_project_npm_dependencies

ChatGPT
Device discovery and setup belong in the Workspace card. For any device list/status/selection or add/connect/manage local/cloud machine request, call open_workspace({goal:'Manage devices'}) exactly once to show machine states and setup, even when devices are connected. If list_devices returns no connected devices during any task, open the same card instead of giving only a text answer. Do not start a billable Codespace without explicit user consent. Quick completed commands and ordinary file reads with connected machines need no card. For pending/running/cancelling raw commands, call open_workspace({}) at most once for live Activity, then wait without additional cards. For a tracked saved-project request, open_workspace once with the original goal and requestId, preserving project and conversationId. When building a new supported app with Live App Preview, create and save the app before opening that one card. Never mount duplicate cards during progress checks or transcript history; commands and run reads return data directly. Install dependencies declared in the saved project's package.json using npm install. This may contact npm registries, run package scripts and update project files. Requires local approval. Use wait_process_task with the returned taskId while the installation is active.

list_cloud_machines

ChatGPT
Device discovery and setup belong in the Workspace card. For any device list/status/selection or add/connect/manage local/cloud machine request, call open_workspace({goal:'Manage devices'}) exactly once to show machine states and setup, even when devices are connected. If list_devices returns no connected devices during any task, open the same card instead of giving only a text answer. Do not start a billable Codespace without explicit user consent. Quick completed commands and ordinary file reads with connected machines need no card. For pending/running/cancelling raw commands, call open_workspace({}) at most once for live Activity, then wait without additional cards. For a tracked saved-project request, open_workspace once with the original goal and requestId, preserving project and conversationId. Never mount duplicate cards during progress checks or transcript history; commands and run reads return data directly. Read linked GitHub Codespaces including stopped machines absent from list_devices. For a device-status or setup request, show the account's machines and actions in one Workspace card with open_workspace({goal:'Manage devices'}), not only a chat table. This call does not start or create a Codespace. If multiple machines exist, let the user select in the card; start only with explicit consent for the exact stopped machine and billing warning. A running Codespace may still need its Terminal Commands companion to connect.

list_devices

ChatGPT
Before other Terminal Commands tools for a new request, call open_workspace once to show the inline Activity/Changes card. Reuse the conversationId and selected project returned by the previous request in this same conversation, even after it finished; only requestId changes. Continue the same request with its existing runId; submit_project_process and get_project_run show its Activity at the current step in the chat. List machines currently connected to this authenticated account.

list_directory

ChatGPT
Before other Terminal Commands tools for a new request, call open_workspace once to show the inline Activity/Changes card. Reuse the conversationId and selected project returned by the previous request in this same conversation, even after it finished; only requestId changes. Continue the same request with its existing runId; submit_project_process and get_project_run show its Activity at the current step in the chat. List a directory inside the selected machine's locally approved roots.

list_projects

ChatGPT
Before other Terminal Commands tools for a new request, call open_workspace once to show the inline Activity/Changes card. Reuse the conversationId and selected project returned by the previous request in this same conversation, even after it finished; only requestId changes. Continue the same request with its existing runId; submit_project_process and get_project_run show its Activity at the current step in the chat. List this account's saved projects and recent runs. A project name identifies a saved path and machine, not a grant of access.

open_workspace

ChatGPT
Required first tool for every new Terminal Commands request, including device/status checks and simple file operations. Use {} for general checks; preserve the active selection by passing its projectId. Recover an existing run with runId alone. For file or coding work, pass the original goal and one stable requestId plus the selected projectId or an explicitly named projectName. A known project starts or recovers its run in this first call; otherwise show the picker and wait for selection. Never guess a folder or silently switch the active project.

read_text_file

ChatGPT
Before other Terminal Commands tools for a new request, call open_workspace once to show the inline Activity/Changes card. Reuse the conversationId and selected project returned by the previous request in this same conversation, even after it finished; only requestId changes. Continue the same request with its existing runId; submit_project_process and get_project_run show its Activity at the current step in the chat. Read a bounded UTF-8 file from the selected machine's approved roots.

save_project

ChatGPT
Before other Terminal Commands tools for a new request, call open_workspace once to show the inline Activity/Changes card. Reuse the conversationId and selected project returned by the previous request in this same conversation, even after it finished; only requestId changes. Continue the same request with its existing runId; submit_project_process and get_project_run show its Activity at the current step in the chat. Save a named project on a connected machine after validating its folder inside locally approved roots. Names must be unique in this account.

start_cloud_machine

ChatGPT
Device discovery and setup belong in the Workspace card. For any device list/status/selection or add/connect/manage local/cloud machine request, call open_workspace({goal:'Manage devices'}) exactly once to show machine states and setup, even when devices are connected. If list_devices returns no connected devices during any task, open the same card instead of giving only a text answer. Do not start a billable Codespace without explicit user consent. Quick completed commands and ordinary file reads with connected machines need no card. For pending/running/cancelling raw commands, call open_workspace({}) at most once for live Activity, then wait without additional cards. For a tracked saved-project request, open_workspace once with the original goal and requestId, preserving project and conversationId. Never mount duplicate cards during progress checks or transcript history; commands and run reads return data directly. Start an existing stopped GitHub Codespace by exact name. Requires the user's explicit confirmation for this exact machine, after warning that GitHub usage may be billed; never call this automatically from a device-offline error or a status check. If multiple machines exist, first list them and get the user's selection. Does not create a Codespace or execute commands. After starting, use list_cloud_machines and list_devices to check GitHub and companion state separately.

start_project_preview

ChatGPT
Device discovery and setup belong in the Workspace card. For any device list/status/selection or add/connect/manage local/cloud machine request, call open_workspace({goal:'Manage devices'}) exactly once to show machine states and setup, even when devices are connected. If list_devices returns no connected devices during any task, open the same card instead of giving only a text answer. Do not start a billable Codespace without explicit user consent. Quick completed commands and ordinary file reads with connected machines need no card. For pending/running/cancelling raw commands, call open_workspace({}) at most once for live Activity, then wait without additional cards. For a tracked saved-project request, open_workspace once with the original goal and requestId, preserving project and conversationId. When building a new supported app with Live App Preview, create and save the app before opening that one card. Never mount duplicate cards during progress checks or transcript history; commands and run reads return data directly. Start a private Live App Preview for the saved Vite app or static site in this run. Requires Preview access and local companion approval. Once ready, the owner can open the signed-in browser link. Use get_project_run to check readiness after the launch task completes.

submit_process

ChatGPT
Before other Terminal Commands tools for a new request, call open_workspace once to show the inline Activity/Changes card. Reuse the conversationId and selected project returned by the previous request in this same conversation, even after it finished; only requestId changes. Continue the same request with its existing runId; submit_project_process and get_project_run show its Activity at the current step in the chat. Submit a locally approved executable, return a task ID immediately, then use get_process_task to retrieve its status and bounded output. Provide a stable idempotencyKey to prevent duplicate execution on retry.

submit_project_process

ChatGPT
Before other Terminal Commands tools for a new request, call open_workspace once to show the inline Activity/Changes card. Reuse the conversationId and selected project returned by the previous request in this same conversation, even after it finished; only requestId changes. Continue the same request with its existing runId; submit_project_process and get_project_run show its Activity at the current step in the chat. Submit one locally approved command in the run's saved project folder. Use this for every command, including later commands in the same run. Generate an operationId for each intentional command; reuse it on retries. Observe up to eight seconds. If still pending, running or cancelling, repeatedly call wait_process_task with its taskId and latest eventSequence until terminal. Keep this turn active and continue the original goal after the result. Command results return through server tools independently of the Activity card or an open chat page. Unknown status requires reconciliation, never automatic replay.

wait_process_task

ChatGPT
Before other Terminal Commands tools for a new request, call open_workspace once to show the inline Activity/Changes card. Reuse the conversationId and selected project returned by the previous request in this same conversation, even after it finished; only requestId changes. Continue the same request with its existing runId; submit_project_process and get_project_run show its Activity at the current step in the chat. Wait for a new event or terminal state, without repeatedly polling the machine. Returns the latest snapshot when the task advances or after at most 20 seconds.

workspace_compatibility

ChatGPT
Before other Terminal Commands tools for a new request, call open_workspace once to show the inline Activity/Changes card. Reuse the conversationId and selected project returned by the previous request in this same conversation, even after it finished; only requestId changes. Continue the same request with its existing runId; submit_project_process and get_project_run show its Activity at the current step in the chat. Read-only compatibility probe. Confirms authenticated MCP tool calls; the embedded UI separately checks bridge initialization, host context and model-context updates.

write_text_file

ChatGPT
Before other Terminal Commands tools for a new request, call open_workspace once to show the inline Activity/Changes card. Reuse the conversationId and selected project returned by the previous request in this same conversation, even after it finished; only requestId changes. Continue the same request with its existing runId; submit_project_process and get_project_run show its Activity at the current step in the chat. Create or overwrite a file after approval on the selected machine.

Capabilities

WritesInteractive

Example Prompts

Click any prompt to copy it.

Similar Apps

Listed on MCP App Store

Listed on MCP App Store

Add this badge to your site or README. It links to this page.

HTML

<a href="https://mcp-app-store.keenethics-labs.com/app/terminal-commands"><img src="https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg" alt="Listed on MCP App Store" width="220" height="44"></a>

Markdown

[![Listed on MCP App Store](https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg)](https://mcp-app-store.keenethics-labs.com/app/terminal-commands)