caretz docs

caretz is a small, sandboxed coding assistant in Go that works well with models you run on your own hardware. Each page here is short and does one job; use the sidebar to dig deeper, or ask caretz itself to read these docs for you.

New to caretz?

Install caretz:

Install script Build from source

curl -fsSL https://raw.githubusercontent.com/makkalot/caretz/main/install.sh | sh

Detects your OS and architecture, verifies the checksum, and installs to ~/bin/caretz.

git clone https://github.com/makkalot/caretz.git
cd caretz
make install

Needs Go 1.25.8+, Git, and Make. Installs to ~/bin/caretz; nothing beyond the Go standard library and golang.org/x.

Then connect a model (a local server or a hosted provider) and give it a task:

caretz setup
caretz -p "explain this repository"

If caretz isn’t found, add ~/bin to your PATH; see Install .

InstallInstall script or build from source. Run a local modelUse llama.cpp, Ollama, or LM Studio on your GPU. Use caretzSessions, one-shot tasks, plan mode. Connect a hosted modelOpenAI-compatible providers.