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

# Process Command

> CLI reference for the process command

# Process Command

Process individual GitHub issues with Simili Bot analysis.

## Syntax

```bash theme={null}
simili process [OPTIONS]
```

## Options

| Option       | Short | Type   | Description                                | Default               |
| ------------ | ----- | ------ | ------------------------------------------ | --------------------- |
| `--issue`    | `-i`  | file   | Path to issue JSON file                    | -                     |
| `--number`   | `-n`  | number | Issue number to fetch directly from GitHub | -                     |
| `--repo`     |       | string | Repository override (`owner/repo`)         | -                     |
| `--org`      |       | string | Organization override                      | -                     |
| `--config`   | `-c`  | file   | Path to configuration file                 | `.github/simili.yaml` |
| `--dry-run`  |       | bool   | Run without posting to GitHub              | false                 |
| `--workflow` | `-w`  | string | Workflow preset name                       | `issue-triage`        |
| `--verbose`  | `-v`  | bool   | Verbose output                             | false                 |
| `--help`     | `-h`  | bool   | Show help message                          | -                     |

## Examples

### Basic processing

Process a single issue from a JSON file:

```bash theme={null}
simili process --issue event.json --config .github/simili.yaml
```

### Fetch issue directly from GitHub

Fetch issue by number without a local JSON file:

```bash theme={null}
simili process --number 42 --repo owner/repo --config .github/simili.yaml
```

### Dry-run (Safe testing)

Test without posting to GitHub:

```bash theme={null}
simili process --issue event.json --config .github/simili.yaml --dry-run
```

### Custom workflow

Use a different analysis pipeline:

```bash theme={null}
simili process --issue event.json --workflow similarity-only
```

Available workflows:

* `issue-triage` - Full analysis (default)
* `similarity-only` - Semantic search only
* `index-only` - Indexing only

### Verbose output

Show detailed step-by-step execution:

```bash theme={null}
simili process --issue event.json --verbose
```

## Next steps

<CardGroup cols={2}>
  <Card title="Index command" href="/reference/cli/index-command">
    Bulk index issues and PRs
  </Card>

  <Card title="Auto-close command" href="/reference/cli/auto-close-command">
    Auto-close duplicate issues
  </Card>

  <Card title="PR duplicate command" href="/reference/cli/pr-duplicate-command">
    Detect duplicate pull requests
  </Card>

  <Card title="Batch command" href="/reference/cli/batch-command">
    Batch process multiple issues
  </Card>
</CardGroup>
