Skip to content
Itervox

Getting Started

Install

Section titled “Install”

Itervox is a single Go binary. Install it with Homebrew:

Terminal window
brew tap vnovick/tap && brew install itervox

Or download the latest release from GitHub Releases.

Prerequisites

Section titled “Prerequisites”

Quick Setup

Section titled “Quick Setup”

1. Initialize WORKFLOW.md

Section titled “1. Initialize WORKFLOW.md”

Navigate to your project repo and run:

Terminal window
itervox init --tracker linear --runner claude

This scans your repository, detects the tech stack, and generates a WORKFLOW.md starter.

For GitHub Issues:

Terminal window
itervox init --tracker github --runner claude

2. Configure secrets

Section titled “2. Configure secrets”

Create a .itervox/.env file (gitignored) with your API keys:

Terminal window
# For Linear
LINEAR_API_KEY=lin_api_xxxxx


# For GitHub (use a personal access token with repo scope)
GITHUB_TOKEN=ghp_xxxxx

Reference them in WORKFLOW.md as $LINEAR_API_KEY or $GITHUB_TOKEN.

3. Run

Section titled “3. Run”
Terminal window
itervox -workflow WORKFLOW.md

Itervox starts polling your tracker, spawning agents for active issues, and streaming logs to the terminal.

Open the dashboard at http://localhost:8090 to see the Kanban board.

4. (Optional) Verbose mode

Section titled “4. (Optional) Verbose mode”
Terminal window
itervox -workflow WORKFLOW.md -verbose

Enables DEBUG-level logging including agent output.

What happens next

Section titled “What happens next”
  1. Itervox polls your tracker for issues in active states (default: “Todo”, “In Progress”)
  2. For each issue, it creates an isolated workspace (clone or worktree)
  3. An AI agent is spawned with your WORKFLOW.md prompt template
  4. The agent works on the issue, creates a branch, and submits a PR
  5. Itervox transitions the issue state on success

All of this is visible in real time via the web dashboard or terminal UI.

Next steps

Section titled “Next steps”