Rizz docs

Introduction

Rizz is the lightest, most connectable coding agent harness — a CLI agent loop that's minimal by default with power on demand.

Quickstart

Install Rizz from source today (Homebrew tap planned for v1), launch the TUI, and connect a model provider.

Core concepts

The Rizz loop, the reliability guarantees built into it, and the two run modes — Simple and Workspace.

Model providers

Rizz is provider-agnostic: use a subscription, bring your own key, or cloud creds across a curated catalog. Credentials live in the OS keychain.

Commands & keys

The Rizz command palette and keyboard shortcuts, with the build status of each command.

Workspace mode

Workspace mode (planned): opt-in parallel git-worktree agents, shared memory, and a per-branch greploop merge gate. Power summoned, not shipped.

Themes

Built-in Rizz themes hot-swap with no restart. A theme defines only the token palette and a few glyphs; layout is theme-independent.

States you'll see

The interface states in Rizz — empty, loading, offline, rate-limited, auth-expired, and bad-edit — and which are shipped vs planned.

Run modes

One Rizz binary, four run modes: interactive TUI, print/JSON, RPC, and SDK.

Contributing

Rizz dogfoods the discipline it ships: a worktree-per-task dev loop, strict TypeScript, a footprint budget, and greploop to 5/5 before merge.

Status & roadmap

Where Rizz is today (M2 walking skeleton) and the milestone path to v1, when the core flips to MIT.