Brisk is a provider-agnostic terminal coding harness (Bun, Solid, OpenTUI). It owns the agent loop, tools, permissions, sessions, context compaction, and subagents; @oh-my-pi/pi-ai handles most provider transports and authentication. Cursor models use the Cursor Agent SDK.
- Bun 1.3.14+
- Linux, macOS, or Windows terminal
- Provider credentials, or a keyless local OpenAI-compatible endpoint
npm — package brisk-ai, binary brisk:
bun add --global --trust brisk-ai
brisk versionUse --trust so postinstall can add Bun's global bin directory to your PATH. Node is not supported.
Standalone — download the release for your platform (brisk-linux-x64, brisk-linux-arm64, brisk-darwin-x64, brisk-darwin-arm64, or brisk-windows-x64) and use its directory as-is. Verify brisk-release-SHA256SUMS before extracting when installing manually.
Source:
bun install --frozen-lockfile
bun run devBrisk checks for a newer release after the TUI's first frame. When notified, update either a global package installation or a complete standalone release directory with:
brisk updateUser data and config paths: Configuration.
export ANTHROPIC_API_KEY='...' # or: brisk auth login anthropic
brisk models --refresh
brisk --model anthropic/claude-sonnet-4-5 /path/to/projectThe TUI mounts before configuration, sessions, providers, or network I/O. Set defaultModel in config to skip interactive model selection.
brisk [directory] [--model M] [--permission-mode safe|write|yolo] [--continue | --session ID] [--fake-provider]
brisk auth <login|logout|status> [provider]
brisk models [--refresh] brisk sessions brisk doctor brisk bench brisk update brisk version
Slash commands, keybindings, and permission modes: Usage. Providers and OAuth: Providers.
| Topic | Document |
|---|---|
| Configuration and paths | docs/CONFIGURATION.md |
| Auth and models | docs/PROVIDERS.md |
| MCP servers | docs/MCP.md |
| Extensions | docs/EXTENSIONS.md |
| Interactive reference | docs/USAGE.md |
| Problems | docs/TROUBLESHOOTING.md |
| Code layout | ARCHITECTURE.md |
| Contributing | CONTRIBUTING.md |