Skip to main content
The /ai command generates an AI-powered response within a Discord thread. The AI can read files, search code, and find files in the Effect repository to provide accurate, context-aware answers.
This command requires the Manage Messages permission and can only be used inside a thread channel.

Usage

/ai [prompt] [reasoning]

Parameters

prompt
string
An optional extra instruction added to the message history before the AI generates its response. Use this to guide or focus the AI’s answer.
reasoning
string
default:"medium"
The reasoning effort level for the AI model. Accepted values are low, medium, or high. Higher effort produces more thorough responses at the cost of speed.

Behavior

When you run /ai, the bot immediately replies with an ephemeral message:
The clanker is thinking…
A Cancel button appears alongside this message. While the AI is working, the message updates to show how many tool calls have been made (e.g., The clanker is thinking... (tool calls: 3)). Once the AI finishes generating a response, the ephemeral message updates to show the result along with an Accept button.
1

Run the command

Use /ai inside a thread. Optionally provide a prompt and a reasoning level.
2

Wait for generation

The bot shows The clanker is thinking... while the AI works. You can click Cancel at any time to stop generation.
3

Review the response

When complete, the AI’s response appears in the ephemeral message. Review it before publishing.
4

Accept or cancel

Click Accept to post the response publicly to the thread. Click Cancel (if still available) to discard it.

Tools available to the AI

The AI has access to three tools for exploring the Effect repository:
ToolDescription
readReads a file (or a line range of a file) from the Effect repository
rgRuns rg (ripgrep) to search for patterns across the repository
globFinds files matching a glob pattern (e.g., **/*.ts)

Permissions

This command requires the Manage Messages Discord permission. Users without this permission cannot run /ai.

Error cases

If you run /ai outside of a thread, the bot responds with an ephemeral error message:
This command can only be used in a thread
Navigate into a thread and try again.
If the AI encounters an error during generation (for example, an API failure), the ephemeral “thinking” message is automatically deleted.

Build docs developers (and LLMs) love