Maven docs

Maven indexes the questions and answers in the channels you choose. When someone asks something that's been answered before — similar in meaning, not just wording — it links them to the original answer. Runs on a local model: no API keys, no per-message cost, your data stays on your machine.

Find answers

Search the server's memory — or let Maven do it automatically.

/maven stats

/maven stats

See how much wisdom is preserved here — how many questions Maven has indexed for this server.

Examples
/maven stats

/maven help

/maven help

Show what Maven does and how to use it.

Examples
/maven help

Settings

Control where Maven listens and how it replies.

/maven enable / disable

Manage Server
/maven enable · /maven disable

Turn Maven on or off for this server. When disabled, it neither indexes nor replies.

Examples
/maven enable/maven disable

/maven watch / unwatch

Manage Server
/maven watch channel:<channel> · /maven unwatch channel:<channel>

Manage the channel allowlist. Maven only ever indexes and replies in channels you've explicitly added — everything else is invisible to it.

Options
  • channelrequiredText channel to watch (or stop watching)
Examples
/maven watch channel:#help/maven unwatch channel:#off-topic

/maven sensitivity

Manage Server
/maven sensitivity percent:<50–95>

How close two questions must be to count as a repeat. Higher is stricter — fewer, more confident matches. Default is 78.

Options
  • percentrequiredMatch threshold, 50–95 (default 78)
Examples
/maven sensitivity percent:85

/maven reply

Manage Server
/maven reply mode:<public|quiet|off>

How Maven responds when it finds a repeat: public (visible to everyone), quiet (auto-deletes after 60 seconds), or off (never reply, just keep indexing).

Options
  • moderequiredReply mode (public, quiet, off)
Examples
/maven reply mode:quiet

/maven show

Manage Server
/maven show

Show Maven's current settings — enabled state, watched channels, sensitivity, and reply mode.

Examples
/maven show

Manage the index

Backfill history and remove entries.

/maven import

Manage Server
/maven import channel:<channel> [messages]

Scan a channel's recent history and index past questions — between 100 and 5,000 messages back. Great for giving Maven a memory on day one instead of starting from zero.

Options
  • channelrequiredChannel to import from
  • messagesHow many messages back to scan, 100–5000 (default applies if omitted)
Examples
/maven import channel:#help messages:2000

/maven forget

Manage Server
/maven forget link:<message link>

Remove a specific question from the index. Right-click the message → Copy Message Link and paste it here.

Options
  • linkrequiredRight-click message → Copy Message Link
Examples
/maven forget link:https://discord.com/channels/…

FAQ

Does Maven send my server's messages to an AI company?

No. Maven is self-hosted and runs a local embedding model — questions are indexed and matched on your own machine. Nothing leaves it, and there's no API bill, which is why Maven is free.

Does Maven read every channel?

No. It only sees channels you explicitly add with /maven watch. Everything else is invisible to it, and /maven unwatch removes a channel at any time.

How does matching work — exact words?

By meaning. "How do I get the member role" matches "where do roles come from" if they're semantically close enough. The /maven sensitivity threshold (default 78%) controls how close is close enough.

Can Maven learn from messages sent before it joined?

Yes — /maven import scans up to 5,000 messages of a channel's history and indexes the questions it finds, so Maven is useful on day one.

Troubleshooting: Maven never replies to repeat questions

Check four things with /maven show: the server is enabled, the channel is on the watchlist, reply mode isn't set to off, and sensitivity isn't so high that nothing matches. Also confirm the index isn't empty with /maven stats — run /maven import if it is.

Troubleshooting: Maven matches questions that aren't really repeats

Raise the threshold: /maven sensitivity percent:85 (or higher, up to 95). Higher values require questions to be much closer in meaning before Maven replies. You can also remove a bad index entry with /maven forget.

Troubleshooting: replies feel spammy in busy channels

Switch to quiet mode — /maven reply mode:quiet auto-deletes Maven's reply after 60 seconds, so the asker sees the link but the channel stays clean. Or set mode:off to keep indexing silently and rely on /maven search.