tutr tutr docs terminal hub

WELCOME TO THE TUTR COMMAND HUB

Your terminal, with a little extra help.

tutr translates plain English into shell commands and can run as an interactive wrapper in every terminal.

LATEST: shell-first AI helper for real command-line work

AI ASSISTANCE IN YOUR TERMINAL YOU STAY IN CHARGE

Get Started Usage Guide

Install with uv:

uv tool install tutr

Need uv first? Install uv.

Fast command generation

Translate intent like "create and switch to branch testing" into precise shell commands.

Interactive shell mode

Run tutr as your shell wrapper with context cues in your prompt.

Flexible provider setup

Configure Gemini, Anthropic, OpenAI, or local Ollama in a guided setup flow.

Quick example

Shell mode

[tutr] > git create and switch to a new branch called testing                                                                                                                                      
  git: 'create' is not a git command. See 'git --help'.

  The most similar command is
          reset
                                                                                                                                                                                                                      
  tutr suggests:
    $ git checkout -b testing
    The 'git checkout -b' command creates a new branch named 'testing' and immediately switches to it.
    source: man git-checkout
  

CLI

> tutr-cli git "create and switch to a new branch called testing"                                                                                                                                  
                                                                                                                                                                                                                   
    $ git checkout -b testing

    Creates a new branch named 'testing' and switches the current working directory to it.

    source: man git-checkout