Skip to content

maxktz/hitch

Repository files navigation


Hitch

Share your terminal with coding agents

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

GitHub · NPM · Author

npm version License npm downloads


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

About

Share your terminal with coding agent in one command. Lightweight shell proxy, written in Rust.

Topics

Resources

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors