Skip to main content
The /docs and /docs-v4 commands let you look up API documentation for Effect modules and functions without leaving Discord. Results are displayed as rich embeds with the type signature, description, examples, and a source link.
  • /docs — searches the Effect v3 documentation.
  • /docs-v4 — searches the Effect v4 / effect-smol documentation.

Usage

/docs query:<search term> public:<true|false>
/docs-v4 query:<search term> public:<true|false>

Parameters

query
string
required
The search term. Autocomplete activates after you type at least 3 characters, returning up to 25 fuzzy-matched results. Select a result from the dropdown to submit the exact entry.
public
boolean
required
Controls the visibility of the response.
  • true — the embed is posted publicly so everyone in the channel can see it.
  • false — the embed is sent as an ephemeral message visible only to you.

Autocomplete behavior

As you type in the query field, the bot performs a fuzzy search over the loaded documentation index. Autocomplete results are formatted as:
Module.functionName (tag) (project)
The bot loads documentation from a remote JSON index and refreshes it every 3 hours.
Autocomplete requires a minimum of 3 characters. Typing fewer than 3 characters returns no suggestions.

Result embed

Each result embed includes the following fields:
FieldDescription
AuthorThe npm package name (e.g., effect, @effect/platform)
TitleModule.functionName
DescriptionThe JSDoc description for the function or type
Type signatureFormatted TypeScript signature in a ts code block
ExamplesCode examples from the JSDoc, if present
Source linkA link to the exact line in the source file
FooterAdded in v{version}

Difference between /docs and /docs-v4

CommandDocumentation source
/docsEffect v3 (effect, @effect/* packages)
/docs-v4Effect v4 / effect-smol
Both commands share the same interface and behavior — only the documentation index differs.

Error cases

If you select an autocomplete suggestion that no longer exists in the index (for example, if the index refreshed between your search and your submission), the bot responds with an ephemeral message:
Sorry, that query could not be found.

Build docs developers (and LLMs) love