octorus 0.6.2

A TUI tool for GitHub PR review, designed for Helix editor users
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50

# Configuration Reference

## Global Configuration

File: `~/.config/octorus/config.toml`

```toml
[ai]
# Supported agents: "claude" (Claude Code), "codex" (OpenAI Codex CLI)
reviewer = "claude"
reviewee = "claude"
max_iterations = 10       # Max review-fix cycles (clamped to 100)
timeout_secs = 600        # Timeout per agent call (clamped to 7200)
# prompt_dir = "/custom/path/to/prompts"  # Custom prompt directory

# Additional tools for reviewer (Claude only, --allowedTools format)
# reviewer_additional_tools = ["Skill", "WebSearch"]

# Additional tools for reviewee (Claude only, --allowedTools format)
# reviewee_additional_tools = ["Skill", "Bash(git push:*)"]
```

## Project-Local Overrides

File: `.octorus/config.toml` (created via `or init --local`)

Values in the local config override the global config. Only specify values you want to override.

In headless mode, local overrides require `--accept-local-overrides`:

```bash
or --repo owner/repo --pr 123 --ai-rally --accept-local-overrides
```

## Custom Prompt Templates

Generated by `or init` at `~/.config/octorus/prompts/`.

Available template variables:

| Variable | Description |
|----------|-------------|
| `{{repo}}` | Repository name (owner/repo) |
| `{{pr_number}}` | Pull request number |
| `{{pr_title}}` | Pull request title |
| `{{pr_body}}` | Pull request description body |
| `{{diff}}` | Full diff content |
| `{{changed_files}}` | List of changed file paths |
| `{{previous_review}}` | Previous review comments (re-review only) |
| `{{fix_summary}}` | Summary of fixes applied (re-review only) |