seanyao/roll

 ██████╗  ██████╗ ██╗     ██╗     
 ██╔══██╗██╔═══██╗██║     ██║     
 ██████╔╝██║   ██║██║     ██║     
 ██╔══██╗██║   ██║██║     ██║     
 ██║  ██║╚██████╔╝███████╗███████╗
 ╚═╝  ╚═╝ ╚═════╝ ╚══════╝╚══════╝

中文版 README

Roll — a CLI that lets AI agents pick up backlog items and ship them through your normal git + CI workflow. Works with Claude, Cursor, Codex, Kimi, and others.

Install

curl -fsSL https://seanyao.github.io/roll/install | bash

npm install -g @seanyao/roll

Requirements: Node.js ≥ 22. Roll is a self-contained TypeScript CLI — no runtime engine beyond node.

Use

cd your-project
roll init           # set up Roll here
roll loop on        # let AI work through the backlog (optional)

roll init detects legacy code and routes you to $roll-onboard when appropriate. First time through? Start with Getting started.

Commands

| Command | Description | |---------|-------------| | Autonomy · daily use | | | roll loop <on\|off\|now\|status\|watch\|runs\|log\|story\|events\|eval\|signals\|alert\|fmt\|pr-inbox\|mute\|unmute\|pause\|resume\|reset\|gc> | Manage the autonomous BACKLOG executor (incl. per-cycle result scoring) | | roll loop watch [-n <lines>] [--events\|--raw-events] [--verbose\|--raw] [--attach] | Read-only live observation. Use default first for owner-facing status (phase / quiet / TCR / last signal), --events for compact event debugging, and --raw-events only for audit/debug JSON. Ctrl-C ends the vi