Skip to content

Quick Start Guide

This guide will get you up and running with reviewtask in just a few minutes.

Prerequisites

  • Go 1.19 or later (if building from source)
  • GitHub repository with pull requests
  • AI provider CLI (Claude Code recommended)

1. Installation

Choose your preferred installation method:

Unix/Linux/macOS: 

curl -fsSL https://raw.githubusercontent.com/biwakonbu/reviewtask/main/scripts/install/install.sh | bash

Windows (PowerShell): 

iwr -useb https://raw.githubusercontent.com/biwakonbu/reviewtask/main/scripts/install/install.ps1 | iex

Download the latest release for your platform from the releases page.

go install github.com/biwakonbu/reviewtask@latest

For detailed installation instructions, see the Installation Guide.

2. Verify Installation

reviewtask version

3. Repository Initialization

Navigate to your Git repository and initialize reviewtask:

cd /path/to/your/repository
reviewtask init

This creates: - .pr-review/ directory structure - Default configuration files - Appropriate .gitignore entries

4. Authentication Setup

Set up GitHub authentication:

reviewtask auth login

This will guide you through: - GitHub token creation - Permission verification - Authentication testing

Alternative Authentication Methods

reviewtask checks for authentication in this order:

  1. GITHUB_TOKEN environment variable
  2. Local config file (.pr-review/auth.json)
  3. GitHub CLI (gh auth token)

5. Analyze Your First PR

Now you're ready to analyze PR reviews:

# Analyze current branch's PR
reviewtask

# Or analyze a specific PR
reviewtask 123

The tool will: - Fetch PR reviews and comments from GitHub - Process comments using AI analysis - Generate actionable tasks with priorities - Save results to .pr-review/PR-{number}/

6. Task Management

View and manage your tasks:

# View all task status
reviewtask status

# Show current/next task details
reviewtask show

# Show specific task details
reviewtask show <task-id>

# Update task status as you work
reviewtask update <task-id> doing
reviewtask update <task-id> done

Task Statuses

  • todo - Ready to work on
  • doing - Currently in progress
  • done - Completed
  • pending - Blocked or low priority
  • cancel - No longer relevant

Next Steps

Now that you have reviewtask set up:

  1. Configure priority rules and AI settings
  2. Learn the commands for advanced task management
  3. Understand the workflow for daily development
  4. Troubleshoot any issues you encounter

Daily Workflow

Here's how reviewtask fits into your daily development routine:

Morning Startup

reviewtask show           # What should I work on today?
reviewtask status         # Overall progress across all PRs

During Implementation

reviewtask show <task-id> # Full context for current task
# Work on the task...
reviewtask update <task-id> done

When Blocked

reviewtask update <task-id> pending  # Mark as blocked
reviewtask show                      # Find next task to work on

When Reviews Are Updated

reviewtask                # Re-run to get new feedback
# Tool automatically preserves your work progress

Common Issues

If you encounter issues during setup:

  • Permission errors: Use reviewtask auth check to verify GitHub token permissions
  • Binary not found: Ensure the installation directory is in your PATH
  • AI provider errors: Verify Claude Code CLI is installed and accessible

For detailed troubleshooting, see the Troubleshooting Guide.