Skip to content

Command Reference

This comprehensive guide covers all reviewtask commands, their options, and usage examples.

Core Commands

Main Command

reviewtask [PR_NUMBER]

Analyze PR reviews and generate actionable tasks.

# Analyze current branch's PR
reviewtask

# Analyze specific PR
reviewtask 123

# Clear cache and reprocess all comments
reviewtask --refresh-cache

Options: - --refresh-cache - Clear cache and reprocess all comments

What it does: - Fetches PR reviews and comments from GitHub - Processes comments using AI analysis - Generates actionable tasks with priorities - Saves results to .pr-review/PR-{number}/ - Preserves existing task statuses

Task Management

reviewtask status [options]

Show task status and statistics across PRs.

# Current branch status
reviewtask status

# All PRs
reviewtask status --all

# Specific PR
reviewtask status --pr 123

# Specific branch
reviewtask status --branch feature/new-feature

Options: - --all - Show information for all PRs - --pr <number> - Show information for specific PR - --branch <name> - Show information for specific branch

reviewtask show [task-id]

Show current/next task or specific task details.

# Show current/next task
reviewtask show

# Show specific task details
reviewtask show task-uuid-here

reviewtask update <task-id> <status>

Update task status.

reviewtask update task-uuid-here doing
reviewtask update task-uuid-here done
reviewtask update task-uuid-here pending
reviewtask update task-uuid-here cancel

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

Statistics

reviewtask stats [PR_NUMBER] [options]

Show detailed task statistics with comment breakdown.

# Current branch statistics
reviewtask stats

# Statistics for specific PR
reviewtask stats 123
reviewtask stats --pr 123

# Statistics for all PRs
reviewtask stats --all

# Statistics for specific branch
reviewtask stats --branch feature/new-feature

Output includes: - Comment-level breakdown with task counts - Priority distribution (critical/high/medium/low) - Status distribution (todo/doing/done/pending/cancel) - Completion metrics and progress tracking - File-level summary with affected files

Setup and Configuration

Repository Setup

reviewtask init

Initialize repository with reviewtask configuration.

reviewtask init

What it creates: - .pr-review/ directory structure - Default configuration files - Appropriate .gitignore entries - Repository permission checks

Authentication

reviewtask auth <command>

Manage GitHub authentication.

# Interactive GitHub token setup
reviewtask auth login

# Show current authentication source and user
reviewtask auth status

# Remove local authentication
reviewtask auth logout

# Comprehensive validation of token and permissions
reviewtask auth check

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

Version Management

reviewtask version [VERSION]

Show version information or switch to specific version.

# Show current version with update check
reviewtask version

# Switch to specific version
reviewtask version v1.2.3
reviewtask version latest

# Check for available updates only
reviewtask version --check

reviewtask versions

List available versions from GitHub releases.

reviewtask versions

Shows recent 5 versions with release information.

AI Provider Integration

Prompt Generation

reviewtask prompt <provider> <target>

Generate AI provider command templates.

# Generate PR review workflow template for Claude Code
reviewtask prompt claude pr-review

# Output prompts to stdout for redirection or piping
reviewtask prompt stdout pr-review
reviewtask prompt stdout pr-review > my-workflow.md
reviewtask prompt stdout pr-review | pbcopy  # macOS clipboard
reviewtask prompt stdout pr-review | xclip   # Linux clipboard

Providers: - claude - Creates optimized command templates in .claude/commands/ directory - stdout - Outputs prompts to standard output

Targets: - pr-review - PR review analysis workflow

reviewtask claude <target> (Deprecated)

Legacy command for Claude integration. Use reviewtask prompt claude <target> instead.

Debug and Development

Debug Commands

reviewtask debug fetch <phase> [PR]

Test specific phases independently for troubleshooting.

# Fetch and save PR reviews only (no task generation)
reviewtask debug fetch review 123

# Generate tasks from previously saved reviews only
reviewtask debug fetch task 123

Features: - Automatically enables verbose mode for detailed logging - Isolates specific functionality for testing - Useful for troubleshooting issues

Command Examples

Daily Workflow

# 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

Advanced Usage

# Force complete refresh of all data
reviewtask --refresh-cache

# Comprehensive system check
reviewtask auth check
reviewtask version --check

# Generate documentation workflows
reviewtask prompt claude pr-review
reviewtask prompt stdout pr-review > custom-workflow.md

# Detailed statistics analysis
reviewtask stats --all
reviewtask stats --branch main

Troubleshooting Commands

# Authentication debugging
reviewtask auth status
reviewtask auth check

# Version management
reviewtask versions
reviewtask version latest

# Debug specific functionality
reviewtask debug fetch review 123
reviewtask debug fetch task 123

# Performance analysis
reviewtask stats --pr 123

Global Options

Most commands support these global options:

  • --help - Show command help
  • --version - Show version information (for main command)

Command Aliases

Some commands have aliases for convenience:

  • reviewtask fetch - Alias for main reviewtask command
  • reviewtask (no arguments) - Analyzes current branch's PR

Exit Codes

reviewtask uses standard exit codes:

  • 0 - Success
  • 1 - General error
  • 2 - Authentication error
  • 3 - Configuration error
  • 4 - Network error

Performance Considerations

Cache Management

  • Commands automatically cache GitHub API responses
  • Use --refresh-cache when you need to bypass caching
  • Cache improves performance and reduces API rate limit usage

Large PRs

  • Tool automatically optimizes performance based on PR size
  • Comments >20KB are automatically chunked
  • Parallel processing handles multiple comments efficiently
  • Auto-resume functionality for interrupted processing

Rate Limiting

  • Authenticated requests: 5,000/hour
  • Use reviewtask auth check to monitor rate limit status
  • Tool includes automatic retry logic for rate limit handling

For more detailed information on specific commands, use the --help flag with any command.