rollbaz

Agent-friendly CLI for Rollbar

Install

Install with Homebrew (recommended):

brew tap kevinsheth/tap
brew install rollbaz
rollbaz --version

Download a prebuilt binary from GitHub Releases:

1. Open https://github.com/kevinsheth/rollbaz/releases
2. Download the archive matching your OS/arch (for example rollbaz_v0.1.0_darwin_arm64.tar.gz)
3. Extract it and move rollbaz onto your PATH

Or install from source:

go install github.com/kevinsheth/rollbaz/cmd/rollbaz@latest
rollbaz --help

# local build
go build ./cmd/rollbaz
./rollbaz --help

Configure Projects

Use a Rollbar project token with read access for list/show commands. Use a project token with write access for resolve/reopen/mute commands.

Rollbar token types and permissions: https://docs.rollbar.com/docs/access-tokens

rollbaz project add my-service --token '<ROLLBAR_PROJECT_TOKEN>'
rollbaz project list
rollbaz project use my-service

Tokens are stored in your user config directory.

Core Commands

rollbaz                 # default: list recent active issues for active project
rollbaz active --limit 20
rollbaz recent --limit 20
rollbaz show 274
rollbaz resolve 274 --yes
rollbaz reopen 274 --yes
rollbaz mute 274 --for 2h --yes

Use --format json on list and show commands for LLM-friendly output.

List filters (for rollbaz, active, and recent):

--env <environment>
--status <status>
--since <RFC3339-or-unix-seconds>
--until <RFC3339-or-unix-seconds>
--min-occurrences <count>
--max-occurrences <count>

Examples

# One-time setup
rollbaz project add my-service --token '<READ_TOKEN>'
rollbaz project use my-service

rollbaz active --limit 5
rollbaz recent --limit 5

rollbaz active --env production --status active --since 2026-02-19T00:00:00Z --min-occurrences 5

rollbaz show 274

rollbaz show 274 --format json
rollbaz active --format json --limit 20
rollbaz recent --format json --limit 20

Token Resolution

Token precedence:

1. --token
2. configured --project token
3. active configured project token
4. ROLLBAR_ACCESS_TOKEN

If you are unsure which token to use, see: https://docs.rollbar.com/docs/access-tokens

Checks

go test ./...
go test -race ./...
go test ./internal/... -coverprofile=coverage.out && go run ./scripts/coveragecheck -min 85 -file coverage.out
go run golang.org/x/vuln/cmd/govulncheck@v1.1.4 ./...