Skip to content

docs: update Plane AI credits page to seat-based model and workspace overage#441

Merged
vihar merged 1 commit intomasterfrom
codex/update-ai-credits-documentation
Apr 27, 2026
Merged

docs: update Plane AI credits page to seat-based model and workspace overage#441
vihar merged 1 commit intomasterfrom
codex/update-ai-credits-documentation

Conversation

@vihar
Copy link
Copy Markdown
Contributor

@vihar vihar commented Apr 25, 2026

Motivation

  • Align the docs with the new billing model where credits are included per paid seat rather than pooled by default.
  • Clarify behavior when included credits run out and how workspace-level overage works so admins can choose to continue AI usage.
  • Remove outdated or prescriptive pricing/rollover/top-up content that no longer reflects product behavior and could confuse customers.

Description

  • Rewrote docs/ai/plane-ai-credits.md to explain that credits are assigned per paid seat and to point readers to https://plane.so/pricing#ai-&-credits for current included amounts.
  • Removed legacy sections covering automatic workspace pooling, detailed plan tables, top-up pack pricing, and complex rollover rules.
  • Added a clear section that Plane does not pool credits by default and that workspace admins may enable workspace-level overage to allow continued AI usage after included credits are exhausted.
  • Simplified the FAQ to cover seat allocation, pooling behavior, overage, and where to find up-to-date plan details.

Testing

  • Ran pnpm check:format in the docs repo and the formatting check passed successfully.
  • The formatting run emitted a non-blocking Node engine warning but completed with all files correctly formatted.

Codex Task

Summary by CodeRabbit

  • Documentation
    • Updated AI credits documentation with reorganized information about credit allocation per seat, overage configuration, and workspace-level billing mechanics.

@vercel
Copy link
Copy Markdown

vercel Bot commented Apr 25, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
docs Ready Ready Preview, Comment Apr 25, 2026 2:34pm

Request Review

@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented Apr 25, 2026

📝 Walkthrough

Walkthrough

The AI credits documentation undergoes substantial simplification, removing complex explanations regarding credit drivers, plan-specific allocations, rollover rules, onboarding bonuses, pooling mechanics, and top-up structures. The content is replaced with a streamlined model covering per-seat credit allocation, optional workspace overage, and significantly reduced FAQs.

Changes

Cohort / File(s) Summary
AI Credits Documentation
docs/ai/plane-ai-credits.md
Substantially rewrites AI credit system documentation; removes detailed explanations of credit consumption drivers, plan-by-plan credit amounts, rollover rules, onboarding bonuses, workspace pooling mechanics, top-up credit packs, fair-usage transparency features, and admin alert thresholds. Replaces with simplified model: per-paid-seat credit allocation, no default pooling, optional workspace overage billing, and reduced FAQ set (4 core questions retained).

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~25 minutes

Poem

🐰 ✨ Credits once complex, now clear and lean,
Pooling and bonuses fade from the scene,
Per-seat and simple, the path now shines bright,
Overage stepping in when needed—just right!
Documentation hops forward, refined and serene. 🌿

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title accurately summarizes the main changes: updating the AI credits documentation to reflect a new seat-based billing model and workspace overage feature.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch codex/update-ai-credits-documentation

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Copy Markdown

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 2

🧹 Nitpick comments (1)
docs/ai/plane-ai-credits.md (1)

44-44: Tighten phrasing for readability.

Line 44 is slightly wordy; a shorter phrasing reads cleaner.

✏️ Proposed wording
-- Admins stay in control of whether overage is allowed.
+- Admins control whether overage is allowed.
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@docs/ai/plane-ai-credits.md` at line 44, The sentence "Admins stay in control
of whether overage is allowed." is wordy; replace it with a tighter phrasing
such as "Admins control whether overage is allowed." to improve
readability—locate that exact sentence in docs/ai/plane-ai-credits.md and update
it accordingly (search for the original sentence text to find the spot).
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@docs/ai/plane-ai-credits.md`:
- Line 34: The sentence starting "If a member (or your workspace's included
capacity) runs out of available credits..." mixes seat-level and workspace
semantics; rewrite it to be explicit about the scope (preferably seat-level
only) and remove the workspace-capacity clause so it aligns with "no default
pooling" language, then add a short clause about overage behavior (e.g., AI
usage stops for that seat unless overage is enabled) and ensure the updated
phrasing replaces the current line.
- Line 6: The H1 in the markdown currently reads "Plane AI credits" but the
VitePress sidebar label is "AI credits"; update the H1 in the markdown file to
exactly "AI credits" to match the sidebar label (or alternatively update the
sidebar label to "Plane AI credits"), ensuring the top-level heading string and
the VitePress sidebar label are identical; locate the H1 "Plane AI credits" in
the markdown and change it to "AI credits" (or make the corresponding change to
the sidebar label entry named "AI credits" in the VitePress config) so they are
consistent.

---

Nitpick comments:
In `@docs/ai/plane-ai-credits.md`:
- Line 44: The sentence "Admins stay in control of whether overage is allowed."
is wordy; replace it with a tighter phrasing such as "Admins control whether
overage is allowed." to improve readability—locate that exact sentence in
docs/ai/plane-ai-credits.md and update it accordingly (search for the original
sentence text to find the spot).
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 04b5fa31-e2d4-4190-babd-23b6d725809c

📥 Commits

Reviewing files that changed from the base of the PR and between 3c76435 and 56e9af4.

📒 Files selected for processing (1)
  • docs/ai/plane-ai-credits.md

description: Understand seat-based AI credits, what happens when included credits run out, and how workspace overage keeps your team moving.
---

# Plane AI credits
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

🧩 Analysis chain

🏁 Script executed:

#!/bin/bash
# Verify the H1 in docs/ai/plane-ai-credits.md and inspect sidebar labels in VitePress config.
set -euo pipefail

echo "== H1 in docs/ai/plane-ai-credits.md =="
sed -n '1,40p' docs/ai/plane-ai-credits.md | rg -n '^# '

echo
echo "== Potential sidebar references in docs/.vitepress/config.ts =="
rg -n -C2 'plane-ai-credits|Plane AI credits|How Plane AI credits work|/ai/' docs/.vitepress/config.ts

Repository: makeplane/docs

Length of output: 406


H1 heading "Plane AI credits" does not match the sidebar label "AI credits".

The page heading on line 6 must be updated to match the sidebar label defined in docs/.vitepress/config.ts (line 627). Either rename the H1 to "AI credits" or update the sidebar label to "Plane AI credits"—both must be consistent per coding guidelines.

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@docs/ai/plane-ai-credits.md` at line 6, The H1 in the markdown currently
reads "Plane AI credits" but the VitePress sidebar label is "AI credits"; update
the H1 in the markdown file to exactly "AI credits" to match the sidebar label
(or alternatively update the sidebar label to "Plane AI credits"), ensuring the
top-level heading string and the VitePress sidebar label are identical; locate
the H1 "Plane AI credits" in the markdown and change it to "AI credits" (or make
the corresponding change to the sidebar label entry named "AI credits" in the
VitePress config) so they are consistent.

## What happens when included credits run out

## Credit consumption patterns
If a member (or your workspace's included capacity) runs out of available credits for the billing period, AI usage can stop unless overage is enabled.
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

Clarify the scope of “runs out” to avoid mixed seat vs workspace semantics.

Line 34 currently blends per-member and workspace capacity language, which can read as contradictory with “no default pooling.” Consider using one explicit model statement here (seat-level only, plus overage behavior).

✏️ Proposed wording
-If a member (or your workspace's included capacity) runs out of available credits for the billing period, AI usage can stop unless overage is enabled.
+If a seat exhausts its included credits for the billing period, AI usage for that seat can stop unless workspace overage is enabled.
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@docs/ai/plane-ai-credits.md` at line 34, The sentence starting "If a member
(or your workspace's included capacity) runs out of available credits..." mixes
seat-level and workspace semantics; rewrite it to be explicit about the scope
(preferably seat-level only) and remove the workspace-capacity clause so it
aligns with "no default pooling" language, then add a short clause about overage
behavior (e.g., AI usage stops for that seat unless overage is enabled) and
ensure the updated phrasing replaces the current line.

@vihar vihar merged commit e3c9b2d into master Apr 27, 2026
5 checks passed
@vihar vihar deleted the codex/update-ai-credits-documentation branch April 27, 2026 09:35
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants