Project Scoping

Kernels are scoped to your project directory. rat py in ~/Projects/foo creates py@foo, separate from py@bar in another project.

Status

rat status

NAME             STATUS   CWD                   VENV
py@myproject     running  ~/Projects/myproject   .venv
py@other         stopped  ~/Projects/other       .venv
r@myproject      running  ~/Projects/myproject   —

Verbose:

rat status -v

py@myproject  running
  Python 3.12.1 · 158MB · idle 1m · PID 316257
  http://127.0.0.1:8717/mcp
  ~/Projects/myproject · .venv
  Clients: rat, rat-vscode (6)

Named runtimes

For multiple environments in the same language:

rat add py-ml ~/ml

Auto-detects venv in ~/ml.

rat add py-web --venv ~/web/.venv --cwd ~/web

rat add r-stats --lang r --cwd ~/stats

Point at a specific binary:

rat add py-311 --runtime /opt/python3.11/bin/python3

Configure pi options:

rat add pi-sonnet --lang pi --opt model=claude-sonnet-4-5 --opt thinking=high