Terminal-Pilot 0.1.4

A minimalist CLI tool to connect to OpenRouter and chat with free AI models directly from your terminal.

Terminal Pilot

A minimalist, interactive CLI tool to connect to OpenRouter and chat with free AI models directly from your terminal.

Installation

You can install Terminal Pilot globally directly from PyPI:

pip install Terminal-Pilot

Configuration

Zero configuration required!

Just run tp start. If you don't have an OpenRouter API key set up, the CLI will interactively ask you for it and securely save it for future sessions.

Usage

Start the interactive assistant from anywhere in your terminal:

tp start

Inside the interactive chat, you can instantly load files into the AI's memory by using the /read command:

? You: /read requirements.md
✓ Loaded requirements.md into memory!
? You: Give me a summary of this project.

Changing Models Mid-Chat

If a model hits a rate limit or you want to switch to a different one, you don't need to exit. Just type /model to hot-swap:

? You: /model
✓ Switched model to: google/gemma-3

Pipe Support (stdin)

You can pipe data directly into the AI to analyze logs, code, or command outputs instantly without opening an interactive chat:

cat error.log | tp ask "Why is this crashing?"
git diff | tp ask "Write a commit message for these changes"
tp ask "What is the command to undo a git commit?"

Optional: Custom Rules

You can inject custom system prompts (personas) by feeding it a text or markdown file:

tp start --rule rules.md