refactor: rename cq to issuebot

Author: JonCanning

.goreleaser.yaml

@@ -2,7 +2,7 @@ version: 2
 
 builds:
   - main: ./main.go
-    binary: cq
+    binary: issuebot
     env:
       - CGO_ENABLED=0
     goos:
@@ -12,7 +12,7 @@ builds:
       - amd64
       - arm64
     ldflags:
-      - -s -w -X github.com/tinybluerobots/cq/cmd.Version={{.Version}}
+      - -s -w -X github.com/tinybluerobots/issuebot/cmd.Version={{.Version}}
 
 archives:
   - format: tar.gz

README.md

@@ -1,62 +1,62 @@
-# cq
+# issuebot
 
-[![Go Version](https://img.shields.io/badge/Go-1.26-blue?logo=go)](https://pkg.go.dev/github.com/tinybluerobots/cq)
+[![Go Version](https://img.shields.io/badge/Go-1.26-blue?logo=go)](https://pkg.go.dev/github.com/tinybluerobots/issuebot)
 
 Autonomous GitHub issue processor powered by any CLI tool. Watches repos for open issues, dispatches a command to resolve them, and pushes fixes or opens PRs.
 
 ## Install
 
-Download a prebuilt binary from the [latest release](https://github.com/tinybluerobots/cq/releases/latest).
+Download a prebuilt binary from the [latest release](https://github.com/tinybluerobots/issuebot/releases/latest).
 
 Or via `go install`:
 
 ```bash
-go install github.com/tinybluerobots/cq@latest
+go install github.com/tinybluerobots/issuebot@latest
 ```
 
 Or build from source:
 
 ```bash
-git clone https://github.com/tinybluerobots/cq.git
-cd cq
-go build -o cq .
+git clone https://github.com/tinybluerobots/issuebot.git
+cd issuebot
+go build -o issuebot .
 ```
 
 ## Usage
 
 ```bash
 # Watch current directory's repo with Claude
-cq --command "claude -p {prompt} --dangerously-skip-permissions"
+issuebot --command "claude -p {prompt} --dangerously-skip-permissions"
 
 # Work directly in current directory (no clone)
-cq --local --command "claude -p {prompt} --dangerously-skip-permissions"
+issuebot --local --command "claude -p {prompt} --dangerously-skip-permissions"
 
 # Watch a single repo with Copilot
-cq --repo owner/repo --command "copilot -p {prompt} --yolo"
+issuebot --repo owner/repo --command "copilot -p {prompt} --yolo"
 
 # Watch all repos in an org with Gemini
-cq --org myorg --command "gemini -p {prompt} --yolo"
+issuebot --org myorg --command "gemini -p {prompt} --yolo"
 
-# Only process issues labelled "cq"
-cq --repo owner/repo --label cq --command "claude -p {prompt} --dangerously-skip-permissions"
+# Only process issues labelled "bug"
+issuebot --repo owner/repo --label bug --command "claude -p {prompt} --dangerously-skip-permissions"
 
 # Preview what the command would do without pushing
-cq --repo owner/repo --dry-run --command "claude -p {prompt} --dangerously-skip-permissions"
+issuebot --repo owner/repo --dry-run --command "claude -p {prompt} --dangerously-skip-permissions"
 
 # Push fixes directly instead of opening PRs
-cq --repo owner/repo --strategy commit --command "copilot -p {prompt} --yolo"
+issuebot --repo owner/repo --strategy commit --command "copilot -p {prompt} --yolo"
 
 # Poll every 5 minutes with 10 workers
-cq --org myorg --interval 5m --workers 10 --command "gemini -p {prompt} --yolo"
+issuebot --org myorg --interval 5m --workers 10 --command "gemini -p {prompt} --yolo"
 
 # Get notified on failures via ntfy.sh
-cq --repo owner/repo --ntfy-topic my-alerts --command "copilot -p {prompt} --yolo"
+issuebot --repo owner/repo --ntfy-topic my-alerts --command "copilot -p {prompt} --yolo"
 
 # Log to a file for background operation
-cq --org myorg --log-file ~/.cq/cq.log --command "claude -p {prompt} --dangerously-skip-permissions"
+issuebot --org myorg --log-file ~/.issuebot/issuebot.log --command "claude -p {prompt} --dangerously-skip-permissions"
 
 # Use any command that reads from stdin
-cq --local --command "./my-issue-handler.sh"
+issuebot --local --command "./my-issue-handler.sh"
 ```
 
 ### Flags
@@ -69,10 +69,10 @@ cq --local --command "./my-issue-handler.sh"
 | `--strategy` | `pr` | Git strategy: `pr` (branch + PR) or `commit` (push to default branch) |
 | `--interval` | `30s` | Polling interval |
 | `--workers` | `5` | Max concurrent repo workers |
-| `--workspace` | `~/.cq/repos` | Directory for cloned repos |
+| `--workspace` | `~/.issuebot/repos` | Directory for cloned repos |
 | `--local` | `false` | Use current directory instead of cloning |
 | `--command` | **(required)** | Command to run (prompt via stdin or `{prompt}` placeholder) |
-| `--prompt-file` | `~/.cq/prompt.tmpl` | Path to prompt template file |
+| `--prompt-file` | `~/.issuebot/prompt.tmpl` | Path to prompt template file |
 | `--dry-run` | `false` | Run command but skip push/PR (print diff instead) |
 | `--max-retries` | `3` | Max retry attempts per issue |
 | `--log-file` | | Log file path (defaults to stdout) |
@@ -86,15 +86,15 @@ Requires a GitHub token. Set `GITHUB_TOKEN` or run `gh auth login`.
 
 1. **Polls** GitHub API for open issues (optionally filtered by label)
 2. **Clones** the repo (or uses current dir with `--local`)
-3. **Dispatches** a command (default: Claude CLI) with the issue as a prompt
+3. **Dispatches** the configured command with the issue as a prompt
 4. **Opens a PR** or pushes directly, depending on strategy
-5. **Tracks state** in `~/.cq/state.json` to avoid re-processing
+5. **Tracks state** in `~/.issuebot/state.json` to avoid re-processing
 
 Each repo gets at most one concurrent worker to prevent conflicts. Failed issues are retried up to `--max-retries` times.
 
 ## Prompt Template
 
-On first run, cq writes a default prompt template to `~/.cq/prompt.tmpl`. Edit it to customise how issues are presented to your command. Available template fields:
+On first run, issuebot writes a default prompt template to `~/.issuebot/prompt.tmpl`. Edit it to customise how issues are presented to your command. Available template fields:
 
 | Field | Description |
 |-------|-------------|
@@ -112,24 +112,24 @@ The `--command` flag is required. By default, the prompt is passed via stdin. If
 
 ```bash
 # Claude Code
-cq --command "claude -p {prompt} --dangerously-skip-permissions"
+issuebot --command "claude -p {prompt} --dangerously-skip-permissions"
 
 # GitHub Copilot
-cq --command "copilot -p {prompt} --yolo"
+issuebot --command "copilot -p {prompt} --yolo"
 
 # Google Gemini CLI
-cq --command "gemini -p {prompt} --yolo"
+issuebot --command "gemini -p {prompt} --yolo"
 
 # Any tool that reads stdin
-cq --command "./my-issue-handler.sh"
+issuebot --command "./my-issue-handler.sh"
 ```
 
 ## Per-Issue Configuration
 
 Override defaults per issue by adding a config block to the issue body:
 
 ```markdown
-<!-- cq
+<!-- issuebot
 strategy: commit
 branch: custom-branch-name
 -->
@@ -138,7 +138,7 @@ branch: custom-branch-name
 Example with post-command to request review after PR creation:
 
 ```markdown
-<!-- cq
+<!-- issuebot
 strategy: pr
 post-command: gh pr edit $PR_NUMBER --add-reviewer octocat
 -->
@@ -147,7 +147,7 @@ post-command: gh pr edit $PR_NUMBER --add-reviewer octocat
 | Key | Values | Description |
 |-----|--------|-------------|
 | `strategy` | `pr`, `commit` | Override the default git strategy |
-| `branch` | any string | Custom branch name (default: `cq/issue-{N}`) |
+| `branch` | any string | Custom branch name (default: `issuebot/issue-{N}`) |
 | `post-command` | any command | Shell command to run after PR creation (`$PR_URL` and `$PR_NUMBER` available) |
 
 ## Development

cmd/root.go

@@ -11,7 +11,7 @@ import (
 var Version = "dev"
 
 var rootCmd = &cobra.Command{
-	Use:               "cq",
+	Use:               "issuebot",
 	Short:             "Autonomous GitHub issue processor powered by any CLI tool",
 	Version:           Version,
 	CompletionOptions: cobra.CompletionOptions{DisableDefaultCmd: true},

cmd/watch.go

@@ -14,12 +14,12 @@ import (
 
 	"github.com/google/go-github/v69/github"
 	"github.com/spf13/cobra"
-	"github.com/tinybluerobots/cq/internal/config"
-	"github.com/tinybluerobots/cq/internal/notify"
-	"github.com/tinybluerobots/cq/internal/poller"
-	"github.com/tinybluerobots/cq/internal/prompt"
-	"github.com/tinybluerobots/cq/internal/state"
-	"github.com/tinybluerobots/cq/internal/worker"
+	"github.com/tinybluerobots/issuebot/internal/config"
+	"github.com/tinybluerobots/issuebot/internal/notify"
+	"github.com/tinybluerobots/issuebot/internal/poller"
+	"github.com/tinybluerobots/issuebot/internal/prompt"
+	"github.com/tinybluerobots/issuebot/internal/state"
+	"github.com/tinybluerobots/issuebot/internal/worker"
 	"golang.org/x/oauth2"
 )
 
@@ -113,7 +113,7 @@ func runWatch(cmd *cobra.Command, args []string) error {
 	// State
 	home, _ := os.UserHomeDir()
 
-	stateDir := home + "/.cq"
+	stateDir := home + "/.issuebot"
 	if err := os.MkdirAll(stateDir, 0755); err != nil {
 		return fmt.Errorf("mkdir state dir: %w", err)
 	}

go.mod

@@ -1,4 +1,4 @@
-module github.com/tinybluerobots/cq
+module github.com/tinybluerobots/issuebot
 
 go 1.26
 

internal/config/config.go

@@ -36,7 +36,7 @@ type IssueConfig struct {
 	PostCommand string `yaml:"post-command"`
 }
 
-var issueConfigRe = regexp.MustCompile(`(?s)<!--\s*cq\s*\n(.*?)\n-->`)
+var issueConfigRe = regexp.MustCompile(`(?s)<!--\s*issuebot\s*\n(.*?)\n-->`)
 
 // DefaultCLIConfig returns a CLIConfig with sensible defaults.
 func DefaultCLIConfig() CLIConfig {
@@ -52,7 +52,7 @@ func DefaultCLIConfig() CLIConfig {
 }
 
 // ParseIssueConfig extracts an IssueConfig from an issue body.
-// It looks for a <!-- cq ... --> HTML comment block containing YAML.
+// It looks for a <!-- issuebot ... --> HTML comment block containing YAML.
 func ParseIssueConfig(body string) IssueConfig {
 	var cfg IssueConfig
 
@@ -77,29 +77,29 @@ func ResolveStrategy(cli CLIConfig, issue IssueConfig) string {
 	return cli.Strategy
 }
 
-// ResolveBranch returns the issue-level branch if set, otherwise cq/issue-{N}.
+// ResolveBranch returns the issue-level branch if set, otherwise issuebot/issue-{N}.
 func ResolveBranch(issue IssueConfig, issueNumber int) string {
 	if issue.Branch != "" {
 		return issue.Branch
 	}
 
-	return "cq/issue-" + strconv.Itoa(issueNumber)
+	return "issuebot/issue-" + strconv.Itoa(issueNumber)
 }
 
 func defaultWorkspace() string {
 	home, err := os.UserHomeDir()
 	if err != nil {
-		return ".cq/repos"
+		return ".issuebot/repos"
 	}
 
-	return filepath.Join(home, ".cq", "repos")
+	return filepath.Join(home, ".issuebot", "repos")
 }
 
 func defaultPromptFile() string {
 	home, err := os.UserHomeDir()
 	if err != nil {
-		return ".cq/prompt.tmpl"
+		return ".issuebot/prompt.tmpl"
 	}
 
-	return filepath.Join(home, ".cq", "prompt.tmpl")
+	return filepath.Join(home, ".issuebot", "prompt.tmpl")
 }

internal/config/config_test.go

@@ -11,7 +11,7 @@ import (
 func TestParseIssueConfig_Full(t *testing.T) {
 	body := `Some issue text here.
 
-<!-- cq
+<!-- issuebot
 strategy: commit
 branch: my-feature
 -->
@@ -42,7 +42,7 @@ func TestParseIssueConfig_Empty(t *testing.T) {
 }
 
 func TestParseIssueConfig_PartialFields(t *testing.T) {
-	body := `<!-- cq
+	body := `<!-- issuebot
 strategy: worktree
 -->`
 
@@ -57,7 +57,7 @@ strategy: worktree
 }
 
 func TestParseIssueConfig_UnknownKeysIgnored(t *testing.T) {
-	body := `<!-- cq
+	body := `<!-- issuebot
 strategy: pr
 branch: fix-123
 unknown_key: some_value
@@ -87,7 +87,7 @@ func TestDefaultConfig(t *testing.T) {
 		{"workers", cfg.Workers, 5},
 		{"max-retries", cfg.MaxRetries, 3},
 		{"label", cfg.Label, ""},
-		{"workspace-has-cq", strings.Contains(cfg.Workspace, ".cq/repos"), true},
+		{"workspace-has-issuebot", strings.Contains(cfg.Workspace, ".issuebot/repos"), true},
 		{"workspace-no-tilde", strings.HasPrefix(cfg.Workspace, "~"), false},
 	}
 
@@ -101,7 +101,7 @@ func TestDefaultConfig(t *testing.T) {
 }
 
 func TestParseIssueConfig_MalformedYAML(t *testing.T) {
-	body := `<!-- cq
+	body := `<!-- issuebot
 strategy: [broken
 -->`
 
@@ -115,7 +115,7 @@ func TestDefaultConfig_WorkspaceUsesHomeDir(t *testing.T) {
 	cfg := DefaultCLIConfig()
 	home, _ := os.UserHomeDir()
 
-	expected := filepath.Join(home, ".cq", "repos")
+	expected := filepath.Join(home, ".issuebot", "repos")
 	if cfg.Workspace != expected {
 		t.Errorf("workspace: got %q, want %q", cfg.Workspace, expected)
 	}
@@ -148,13 +148,13 @@ func TestResolveBranch_IssueOverrides(t *testing.T) {
 
 func TestResolveBranch_Default(t *testing.T) {
 	issue := IssueConfig{}
-	if got := ResolveBranch(issue, 42); got != "cq/issue-42" {
-		t.Errorf("got %q, want %q", got, "cq/issue-42")
+	if got := ResolveBranch(issue, 42); got != "issuebot/issue-42" {
+		t.Errorf("got %q, want %q", got, "issuebot/issue-42")
 	}
 }
 
 func TestParseIssueConfig_PostCommand(t *testing.T) {
-	body := "<!-- cq\npost-command: gh pr comment $PR_NUMBER -b 'ready'\n-->"
+	body := "<!-- issuebot\npost-command: gh pr comment $PR_NUMBER -b 'ready'\n-->"
 	cfg := ParseIssueConfig(body)
 
 	if cfg.PostCommand != "gh pr comment $PR_NUMBER -b 'ready'" {
@@ -163,7 +163,7 @@ func TestParseIssueConfig_PostCommand(t *testing.T) {
 }
 
 func TestParseIssueConfig_PostCommandEmpty(t *testing.T) {
-	body := "<!-- cq\nstrategy: pr\n-->"
+	body := "<!-- issuebot\nstrategy: pr\n-->"
 	cfg := ParseIssueConfig(body)
 
 	if cfg.PostCommand != "" {

internal/poller/poller.go

@@ -7,7 +7,7 @@ import (
 	"strings"
 
 	"github.com/google/go-github/v69/github"
-	"github.com/tinybluerobots/cq/internal/ratelimit"
+	"github.com/tinybluerobots/issuebot/internal/ratelimit"
 )
 
 // ErrInvalidRepoFormat is returned when a repo string is not in "owner/name" format.