---
title: "Bot Mentions"
description: "Trigger AI tasks by mentioning @forkline in issues and pull requests."
section: "automation"
url: "https://forkline.dev/docs/automation/bot-mentions"
markdown: "https://forkline.dev/docs/automation/bot-mentions.md"
source: "src/content/docs/automation/bot-mentions.mdx"
---

# Bot Mentions

Trigger AI-powered tasks by mentioning `@forkline` or `@forkline-bot` in issues and pull requests.

## Overview

Bot mentions are the fastest way to turn repository context into an agent task. They work well when you want to:

- Ask questions about code
- Request code changes
- Get help with debugging
- Automate repetitive tasks

> **Info**: Bot mentions work automatically once webhooks are configured. There is no separate feature toggle.

_Interactive figure (BotMentionsDiagram) — see the HTML version of this page._

## Example Prompts

Forkline responds differently depending on where you mention it.

### In Issues

```text
@forkline implement this feature
```

```text
@forkline investigate why the API returns 500 errors
```

```text
@forkline add pagination to the users endpoint
```

### In Pull Requests

```text
@forkline review this PR for security issues
```

```text
@forkline summarize the changes
```

```text
@forkline the tests are failing, please fix them
```

### In Comments

```text
@forkline update the documentation for this function
```

```text
@forkline refactor this to use the new API
```

## Best Practices

### Be Specific

```markdown
# Vague - harder to help
@forkline fix this

# Specific - clear instructions
@forkline The validateEmail function doesn't handle internationalized domain names.
Please update it to support IDN and add tests.
```

### Provide Context

```markdown
@forkline I'm adding pagination to the users endpoint but getting an error.

Current code: src/api/users.ts line 45
Error: "offset must be a number"

Expected: Return 20 users per page with proper pagination headers.
```

### Reference Specific Files

```markdown
@forkline update src/api/users.ts to add rate limiting

Focus on the authenticate() function.
```

### Set Expectations

```markdown
@forkline create a simple fix for this bug - no refactoring needed
```

### One Task Per Mention

Keep each mention scoped to one clear outcome:

```markdown
# Too much at once
@forkline review this PR, add tests, and update the docs

# Better - separate mentions
@forkline review this PR for security issues
```

## Next Steps

- [Configure webhooks](https://forkline.dev/docs/automation/webhooks)
- [Set up CI auto-fix](https://forkline.dev/docs/automation/ci-auto-fix)