reyrodman

Gentle Terminal — AI skill for Claude Code

AI community

Approval-first terminal control for AI coding agents: a pinned MCP server launcher + Agent Skill that lets Claude Code, Codex, Cursor & OpenCode drive real shells, REPLs and TUIs, and supervise other.

How to install Gentle Terminal

This entry records only its repository, not the path inside it, so there is no exact command to give. Open reyrodman/gentle-terminal and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Gentle Terminal does

Alternatives in AI

Gentle AI — Agent Skills Index — When working on this project, load the relevant skill(s) BEFORE writing any code 1.9k ★
Pi Agent VS OpenCode — Customization & Control Comparison — Pi v0.52+ vs OpenCode v1.1+ (Feb 2026) Thesis: Pi and OpenCode are both MIT-licensed, open-source, model-agnos 526 ★
Agentboard — Web GUI for tmux optimized for AI agent TUIs, with support for iOS safari and mac w/ keyboard shortcuts 410 ★

README

gentle-terminal

**Approval-first terminal control for AI coding agents.**

Let Claude Code, Codex, Cursor, OpenCode and any MCP client drive *real* interactive shells, CLIs and TUIs (and even supervise other coding agents) without auto-approving prompts, mistaking timeouts for success, or killing work in progress.

[![CI](https://github.com/reyrodman/gentle-terminal/actions/workflows/ci.yml/badge.svg)](https://github.com/reyrodman/gentle-terminal/actions/workflows/ci.yml) [![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE) [![Node](https://img.shields.io/badge/node-%3E%3D22.12-339933?logo=node.js&logoColor=white)](https://nodejs.org) [![MCP](https://img.shields.io/badge/MCP-stdio%20server-7c3aed)](https://modelcontextprotocol.io) [![Agent Skill](https://img.shields.io/badge/Agent%20Skill-SKILL.md-0ea5e9)](SKILL.md) [![Platforms](https://img.shields.io/badge/platforms-Linux%20%7C%20macOS%20%7C%20Windows-informational)](#supported-platforms)

[Quick start](#quick-start) · [Connect your client](#connect-your-mcp-client) · [Examples](#usage-examples) · [How it works](#how-it-works) · [Safety model](#safety-model) · [FAQ](#faq)

Why gentle-terminal?

Most agent shell tools run one command and hand back its output. That breaks the moment a program is **interactive**: `vim`, `htop`, a Python REPL, `git rebase -i`, an installer asking questions, an SSH login, or another AI agent like Codex CLI waiting for approval.

[terminal-use](https://github.com/computer-agent-labs/terminal-use) solves the mechanics: a real PTY rendered by a real terminal emulator, exposed over MCP. **gentle-terminal adds the judgment** an agent needs to use that power responsibly:

| Without a policy, agents tend to... | gentle-terminal teaches them to... | |