AI quota

Most AI commands spend from a per-user budget of points. The budget refreshes on a 30-minute tumbling window that starts when you run your first AI command. The numbers here are the shipping defaults — a server owner can change every one of them via /ailimits.

Check your own balance anytime with /ai quota. It shows your current points used, the effective budget after boosts, any one-time bonus pool, and how long until the window resets.

How points work

The window opens the moment you invoke an AI command in a server. From there:

• Each call deducts that command's cost from your regular bucket.
• When you don't have enough points, the call is refused with a friendly “your window resets in N minutes” embed — no points are charged on a refusal.
• The window is tumbling, not sliding. It expires 30 minutes after the very first call, and the full bucket refills in a single jump at that moment.

Bot owners (the IDs in BOT_OWNER_ID and BOT_ADDITIONAL_OWNER_IDS) bypass all of this — no window, no charges, no quota footer.

Per-command costs

Defaults at first install. Each row is one entry in COMMAND_POINTS in utils/ai_constants.py:

Command            Cost  Notes
─────────────────────────────────────────────
/ask               1     short Q&A, multi-turn
/ai ask            1     same as /ask, namespaced
/ai think          2     deep reasoning (Gemini Pro)
/ai summarise      2     channel / link / range summary
/ai fallacy        2     message-history scan
/ai modadvice      4     full channel context, ~250 msgs
/ai draftwarn      1     AI-drafted warning (preview first)
/imagine           5     image generation
/upscale           5     image upscale (when invoked)

Default budget: 10 points per user, per 30-minute window.

Anything not listed (including /edit, /ai forget, and /ai quota itself) falls back to a 1-point default. /modai is not on this budget — it runs on its own daily pool; see below.

Boosts and bonuses

Owners can extend any individual user's budget in two ways (both managed through /ailimits):

• Permanent boost.Adds a flat amount to the user's effective budget for every future window — useful for staff or trusted regulars.
• One-time bonus pool. A persistent stash that sits alongside the regular bucket and is not reset by the 30-minute timer.

Drain order matters. When a command costs more than your regular remaining points, the shortfall comes out of the one-time bonus pool — i.e. the regular bucket drains first, and the bonus pool is the fallback. The pool only shrinks when your regular bucket is empty.

/modai runs on its own pool

/modai is the agentic moderation feature and is deliberately kept off the shared budget. It has a dedicated:

• 30 points per 24 hours, per user, tumbling window starting on first charge.
• Dynamic 1 – 3 point cost per call, decided after the planner produces its plan: 1 for simple plans, 2 for moderate, 3 for complex or high-irreversibility plans.
• Admins and owners bypass entirely — no charge, no check.

Heavy mod work therefore won't starve /askusers, and a chatty community won't starve a moderator using /modai.