> ## Documentation Index
> Fetch the complete documentation index at: https://docs.codeant.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# SCM Integration & PR Tools

> Manage pull requests, code reviews, and comments across GitHub, GitLab, Bitbucket, and Azure DevOps

CodeAnt CLI provides a unified interface for managing pull requests, code reviews, and comments across all major SCM platforms. All PR commands auto-detect your SCM platform and repository from the git remote.

## Supported Platforms

| Platform | Hosting |
| - | - |
| **GitHub** | github.com, GitHub Enterprise (self-hosted) |
| **GitLab** | gitlab.com, self-hosted GitLab |
| **Bitbucket** | bitbucket.org, Bitbucket Server / Data Center |
| **Azure DevOps** | dev.azure.com, visualstudio.com |

## Auto-Detection

CodeAnt automatically detects your SCM platform, repository name, and default branch from your git remote:

```bash theme={"theme":"css-variables"}
# These are equivalent - auto-detection handles it
codeant pr list
codeant pr list --remote github --name owner/repo
```

**How it works:**

1. Parses `git remote get-url origin` (supports both SSH and HTTPS URLs)
2. Maps the host to a platform (e.g., `github.com` → `github`)
3. Extracts `owner/repo` from the URL path
4. Detects the default branch from `refs/remotes/origin/HEAD`

For self-hosted instances, CodeAnt uses hostname heuristics (e.g., a host containing "gitlab" maps to GitLab). You can always override with `--remote` and `--name` flags.

## Authentication

See [Setup - SCM Platform Tokens](https://docs.codeant.ai/cli/setup.md#scm-platform-tokens) for authentication configuration.

## Pull Request Management

### pr list

List pull requests (or merge requests) in the repository.

```bash theme={"theme":"css-variables"}
codeant pr list [options]
```

| Option | Description |
| - | - |
| `--name <repo>` | Repository name (`owner/repo`) - auto-detected |
| `--remote <provider>` | SCM platform: `github`, `gitlab`, `bitbucket`, `azure` - auto-detected |
| `--default-branch <branch>` | Default branch name - auto-detected |
| `--source-branch <branch>` | Filter by source branch (partial match) |
| `--author <login>` | Filter by author (fuzzy match) |
| `--state <state>` | `open` or `closed` (default: `open`) |
| `--limit <n>` | Maximum results (default: 20, max: 100) |
| `--offset <n>` | Pagination offset (default: 0) |

**Examples:**

```bash theme={"theme":"css-variables"}
# List open PRs
codeant pr list

# List closed PRs by a specific author
codeant pr list --state closed --author johndoe

# Filter by source branch
codeant pr list --source-branch feature/

# Paginate results
codeant pr list --limit 10 --offset 20
```

**Output:** Returns JSON with PR number, title, state, author, source/target branches, and URLs.

***

### pr get

Get detailed information about a specific pull request, including review analysis data.

```bash theme={"theme":"css-variables"}
codeant pr get [options]
```

| Option | Description |
| - | - |
| `--pr-number <n>` | PR number (**required**) |
| `--name <repo>` | Repository name - auto-detected |
| `--remote <provider>` | SCM platform - auto-detected |
| `--default-branch <branch>` | Default branch - auto-detected |

**Example:**

```bash theme={"theme":"css-variables"}
codeant pr get --pr-number 42
```

**Output:** Returns JSON with PR details including additions, deletions, changed files, and review summary.

***

### pr comments

List all comments on a pull request with optional filtering.

```bash theme={"theme":"css-variables"}
codeant pr comments [options]
```

| Option | Description |
| - | - |
| `--pr-number <n>` | PR number (**required**) |
| `--name <repo>` | Repository name - auto-detected |
| `--remote <provider>` | SCM platform - auto-detected |
| `--default-branch <branch>` | Default branch - auto-detected |
| `--codeant-generated <bool>` | Filter by CodeAnt authorship (`true` or `false`) |
| `--addressed` | Filter by resolved/addressed status |
| `--created-after <date>` | ISO 8601 date filter (e.g., `2026-01-01`) |
| `--created-before <date>` | ISO 8601 date filter |

**Examples:**

```bash theme={"theme":"css-variables"}
# List all comments on PR #42
codeant pr comments --pr-number 42

# List only CodeAnt-generated comments
codeant pr comments --pr-number 42 --codeant-generated true

# List unresolved comments from the last week
codeant pr comments --pr-number 42 --addressed false --created-after 2026-03-13
```

**Output:** Returns JSON with both inline review comments and general issue comments, including reply relationships.

### pr resolve

Resolve a comment thread or conversation on a pull request.

```bash theme={"theme":"css-variables"}
codeant pr resolve [options]
```

| Option | Description |
| - | - |
| `--pr-number <n>` | PR number (**required**) |
| `--name <repo>` | Repository name - auto-detected |
| `--remote <provider>` | SCM platform - auto-detected |
| `--comment-id <id>` | Comment ID (GitHub, Bitbucket) |
| `--thread-id <id>` | Thread or node ID (GitHub GraphQL, Azure DevOps) |
| `--discussion-id <id>` | Discussion ID (GitLab) |

The ID type to use depends on your platform:

| Platform | Use |
| - | - |
| GitHub | `--comment-id` or `--thread-id` (GraphQL node ID) |
| GitLab | `--discussion-id` |
| Bitbucket | `--comment-id` |
| Azure DevOps | `--thread-id` |

**Example:**

```bash theme={"theme":"css-variables"}
codeant pr resolve --pr-number 42 --comment-id 987654321
```

***

## Code Review Management

### code-review list

List code reviews with optional filtering.

```bash theme={"theme":"css-variables"}
codeant code-review list [options]
```

| Option | Description |
| - | - |
| `--name <repo>` | Repository name - auto-detected |
| `--remote <provider>` | SCM platform - auto-detected |
| `--default-branch <branch>` | Default branch - auto-detected |
| `--pr-number <n>` | Filter by PR number |
| `--status <status>` | Filter by status: `PENDING`, `COMPLETED`, `FAILED` |
| `--limit <n>` | Maximum results (default: 20) |
| `--offset <n>` | Pagination offset (default: 0) |

**Examples:**

```bash theme={"theme":"css-variables"}
# List all code reviews
codeant code-review list

# List reviews for a specific PR
codeant code-review list --pr-number 42

# List only completed reviews
codeant code-review list --status COMPLETED
```

***

### code-review get

Get detailed information for a specific code review.

```bash theme={"theme":"css-variables"}
codeant code-review get [options]
```

| Option | Description |
| - | - |
| `--pr-number <n>` | PR number (**required**) |
| `--review-id <id>` | Code review ID (**required**) |
| `--name <repo>` | Repository name - auto-detected |
| `--remote <provider>` | SCM platform - auto-detected |

**Example:**

```bash theme={"theme":"css-variables"}
codeant code-review get --pr-number 42 --review-id rev_abc123
```

**Output:** Returns JSON with review metadata, comments, and line-level feedback.

## Comment Search

### comments search

Search across all CodeAnt comments in a repository.

```bash theme={"theme":"css-variables"}
codeant comments search [options]
```

| Option | Description |
| - | - |
| `--query <term>` | Search term (**required**) |
| `--name <repo>` | Repository name - auto-detected |
| `--remote <provider>` | SCM platform - auto-detected |
| `--limit <n>` | Maximum results (default: 10, max: 50) |
| `--include-addressed` | Include resolved/addressed comments (default: `false`) |
| `--created-after <date>` | ISO 8601 date filter |

**Examples:**

```bash theme={"theme":"css-variables"}
# Search for comments about SQL injection
codeant comments search --query "SQL injection"

# Include resolved comments, limit to 5
codeant comments search --query "authentication" --include-addressed --limit 5

# Search comments created after a specific date
codeant comments search --query "performance" --created-after 2026-01-01
```

**Output:** Returns JSON with matching comments. Search is case-insensitive and searches comment bodies by default. Only CodeAnt-authored comments are included.

## Platform-Specific Notes

### GitHub

* Uses the Octokit SDK under the hood
* Aggregates both review comments (inline) and issue comments
* Supports GitHub Enterprise with custom API URLs

### GitLab

* Uses the GitBeaker SDK
* Works with merge request and approval APIs
* Supports self-hosted instances

### Bitbucket

* Uses the Bitbucket SDK
* Supports both Cloud and Server/Data Center deployments
* Adapts PR/MR terminology automatically

### Azure DevOps

* Uses the Azure DevOps Node API SDK
* Works with organization/project/repository structure
* Supports both `dev.azure.com` and `visualstudio.com` URLs


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.