nirholas / auto-kill-terminal

auto-kill-terminal

Stop AI agents from leaving zombie terminals in VS Code and GitHub Codespaces. Copy-paste terminal management rules for GitHub Copilot, Claude Code, Gemini, Cursor, Windsurf, and more.

v1.0.0SEE LICENSE IN LICENSE

Get started View source

npm install auto-kill-terminal

What it does

Capabilities documented in this repository.

The Problem

See the full documentation for details.

The Fix

See the full documentation for details.

Terminal Management

See the full documentation for details.

Setup by Agent

See the full documentation for details.

Terminal Management

See the full documentation for details.

Terminal Management

See the full documentation for details.

Get started

Install it, then run your first command.

npm install auto-kill-terminal

Read the full getting started guide

Examples

Taken directly from this repository's documentation.

█████╗ ██╗   ██╗████████╗ ██████╗       ██╗  ██╗██╗██╗     ██╗     
  ██╔══██╗██║   ██║╚══██╔══╝██╔═══██╗      ██║ ██╔╝██║██║     ██║     
  ███████║██║   ██║   ██║   ██║   ██║█████╗█████╔╝ ██║██║     ██║     
  ██╔══██║██║   ██║   ██║   ██║   ██║╚════╝██╔═██╗ ██║██║     ██║     
  ██║  ██║╚██████╔╝   ██║   ╚██████╔╝      ██║  ██╗██║███████╗███████╗
  ╚═╝  ╚═╝ ╚═════╝    ╚═╝    ╚═════╝       ╚═╝  ╚═╝╚═╝╚══════╝╚══════╝
                    ████████╗███████╗██████╗ ███╗   ███╗██╗███╗   ██╗ █████╗ ██╗     
                    ╚══██╔══╝██╔════╝██╔══██╗████╗ ████║██║████╗  ██║██╔══██╗██║     
                       ██║   █████╗  ██████╔╝██╔████╔██║██║██╔██╗ ██║███████║██║     
                       ██║   ██╔══╝  ██╔══██╗██║╚██╔╝██║██║██║╚██╗██║██╔══██║██║     
                       ██║   ███████╗██║  ██║██║ ╚═╝ ██║██║██║ ╚████║██║  ██║███████╗
                       ╚═╝   ╚══════╝╚═╝  ╚═╝╚═╝     ╚═╝╚═╝╚═╝  ╚═══╝╚═╝  ╚═╝╚══════╝

# Option 1: Clone and copy what you need
git clone https://github.com/nirholas/auto-kill-terminal.git
cp auto-kill-terminal/.github/copilot-instructions.md your-project/.github/

# Option 2: Just copy the 5 bullet points from "The Fix" into your existing instruction file

Agent                                Terminal
    |                                      |
    |-- run_in_terminal -----------------> | (isBackground: true)
    |   <-- terminal_id: a7b3c9d1          |
    |                                      |
    |-- await_terminal ------------------> | (wait for completion)
    |   <-- output + exit code             |
    |                                      |
    |-- kill_terminal -------------------> | x_x
    |                                      X
    |
    |-- (clean slate for next command)

More examples

Reference

Full README

Complete reference documentation.

Getting started

Install, configure, and run.

Examples

Copy-paste snippets that work.

Issues

Report a bug or request a feature.