Getting Started

Install

Requires Python 3.10+.

Install with uv:

uv tool install tutr

Or install with pipx:

pipx install tutr

Or run without installing:

uvx tutr

From source:

git clone https://github.com/spi3/tutr.git
cd tutr
uv sync

First run setup

On first run, tutr opens an interactive setup flow to choose provider, model, and API key. Supported providers: Gemini, Anthropic, OpenAI, xAI, and Ollama (local, no API key needed).

tutr git "show recent commits"

Use tutr-cli configure anytime to re-run setup.

Auto-start in every terminal

Bash (~/.bashrc)

if [[ $- == *i* ]] && [[ -z "${TUTR_AUTOSTARTED:-}" ]] && [[ -z "${TUTR_SKIP_AUTOSTART:-}" ]]; then
  export TUTR_AUTOSTARTED=1
  exec tutr
fi

Zsh (~/.zshrc)

if [[ -o interactive ]] && [[ -z "${TUTR_AUTOSTARTED:-}" ]] && [[ -z "${TUTR_SKIP_AUTOSTART:-}" ]]; then
  export TUTR_AUTOSTARTED=1
  exec tutr
fi

PowerShell ($PROFILE)

if (-not $env:TUTR_AUTOSTARTED -and -not $env:TUTR_SKIP_AUTOSTART) {
  $env:TUTR_AUTOSTARTED = "1"
  tutr
}

To find or create your PowerShell profile file, run $PROFILE in a PowerShell session. On Windows this is typically ~\Documents\PowerShell\Microsoft.PowerShell_profile.ps1; on Linux/macOS it is typically ~/.config/powershell/Microsoft.PowerShell_profile.ps1.

Note: TUTR_AUTOSTARTED prevents recursive startup because tutr sources your shell rc file.