█▀▄ █ █▀▀ █▀█ █▀▀ ▀█▀ █▀█
█▀▄ █ █▄█ █▄█ █▄▄  █  █▄█
▀▀  ▀ ▀▀▀ ▀ ▀ ▀▀▀  ▀  ▀ ▀

GitHub issues, the easy way

BIGOCTO is an interactive terminal UI for GitHub issues with Claude Agent SDK integration. Browse, create, and manage issues from the terminal. Send issues directly to Claude for AI-assisted coding, or run autonomous loop mode to iterate on issues with quality gates and progress tracking.

Install

npm install -g @bigdealio/bigocto

Requires Node.js >= 18, GitHub CLI (gh) installed and authenticated, and Git.

Usage

bigocto

Arrow keys to navigate, Enter to select, Esc to go back, q to quit.

# Run autonomous loop mode on an issue
bigocto loop -i 42
bigocto loop -i 42 --model claude-opus-4-6 -n 10
bigocto loop -i 42 --no-worktree -q full

Features

Issues

• Browse issues with search and filter
• View full issue details with comments and markdown rendering
• Create new issues with labels and assignee selection
• Manage — close, reopen, add comments, open in browser

Claude Agent

• Send to Claude — launch an AI coding session with full issue context
• Three-tier knowledge — global patterns, repo CLAUDE.md, session logs
• Configurable — model, max turns, include comments

Autonomous Loop Mode

• Iterate — agent loops on an issue until resolved or max iterations
• Quality gates — lint, typecheck, and tests gate each commit
• Worktree isolation — run in a git worktree to keep your working directory clean
• Progress tracking — accumulated learnings persist between iterations
• CLI mode — run headless via bigocto loop

Configuration

• TOML config at ~/.config/bigocto/config.toml
• Multi-repo — watch and switch between repositories
• Persistent settings — model, quality gate mode, worktree preferences

Keybindings

| Key | Action | |-----|--------| | Up / Down | Navigate menu items | | Enter | Select / confirm | | Esc | Go back / cancel | | q | Quit (from main menu) | | ? | Open help screen | | r | Refresh data | | o | Open in browser | | / | Search / filter | | s | Stop loop |

Loop Mode

bigocto loop -i <issue-number> [options]

Options:
  -i, --issue <number>         GitHub issue number (required)
  -m, --model <model>          Claude model (default: claude-sonnet-4-5-20250929)
  -n, --max-iterations <n>     Max iterations (default: 20)
  --no-worktree                Use current folder instead of worktree
  -q, --quality-gate <mode>    full, code-only, or off (default: code-only)

| Strategy | Description | |----------|-------------| | Worktree + Code Only | Isolated worktree, lint + typecheck only (recommended) | | Worktree + Full | Isolated worktree, lint + typecheck + tests | | Current Folder + Full | Work in current directory with all quality gates | | Current Folder + Off | Work in current directory, no quality gates |

Development

git clone https://github.com/BigDeal-io/BigOcto.git
cd BigOcto
npm install
npm run dev        # run with tsx
npm run build      # bundle to dist/
npm run typecheck   # type check
npm test           # run tests

Built With

• Ink - React for interactive CLIs
• Commander - CLI argument parsing
• TypeScript - Type safety
• Claude Agent SDK - AI coding agent

License

MIT - Copyright (c) 2026 Fractional CTO Solutions, a service of BIGDEALIO, LLC

A product of Fractional CTO Solutions - a service of BIGDEALIO, LLC