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.

Where mentions work best
Issues

Ask for implementation or investigation work

Use issue mentions when the task starts from a bug, feature request, or open-ended discussion.

@forkline implement or investigate
Pull Requests

Delegate review or follow-up changes

Use PR mentions when the code already exists and you want review, fixes, or targeted edits.

@forkline review or fix this
Comments

Continue the thread with scoped instructions

Use comments to refine a task, point to files, or break one request into a smaller next action.

@forkline update docs in file X
The same mention syntax works everywhere, but the surrounding thread changes the context Forkline sees.

Example Prompts

Forkline responds differently depending on where you mention it.

In Issues

@forkline implement this feature
@forkline investigate why the API returns 500 errors
@forkline add pagination to the users endpoint

In Pull Requests

@forkline review this PR for security issues
@forkline summarize the changes
@forkline the tests are failing, please fix them

In Comments

@forkline update the documentation for this function
@forkline refactor this to use the new API

Best Practices

Be Specific

# 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

@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

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

Focus on the authenticate() function.

Set Expectations

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

One Task Per Mention

Keep each mention scoped to one clear outcome:

# 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