Brisk

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.

Requirements

• Bun 1.3.14+
• Linux, macOS, or Windows terminal
• Provider credentials, or a keyless local OpenAI-compatible endpoint

Install

npm — package brisk-ai, binary brisk:

bun add --global --trust brisk-ai
brisk version

Use --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 dev

Brisk 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 update

User data and config paths: Configuration.

First run

export ANTHROPIC_API_KEY='...'   # or: brisk auth login anthropic
brisk models --refresh
brisk --model anthropic/claude-sonnet-4-5 /path/to/project

The TUI mounts before configuration, sessions, providers, or network I/O. Set defaultModel in config to skip interactive model selection.

CLI

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.

Documentation

| 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 |

Changelog · Third-party notices · MIT License