Skip to content

Conversation

@danciaclara
Copy link
Collaborator

@danciaclara danciaclara commented Nov 12, 2025


Note

Adds a comprehensive AI credits guide, updates billing docs to reference it, and links the page in the AI sidebar.

  • Docs:
    • Add docs/ai/plane-ai-credits.mdx detailing AI credit system: consumption tiers, plan allocations/rollover, workspace pooling, top-ups, fairness/transparency, and FAQs.
  • Billing:
    • Update docs/workspaces-and-users/billing-and-plans.mdx with new "AI credits and usage" section explaining pooled per-seat AI credits and linking to the detailed guide.
  • Navigation:
    • Add ai/plane-ai-credits to sidebars.ts under the AI category.

Written by Cursor Bugbot for commit 3b528b8. This will update automatically on new commits. Configure here.

Summary by CodeRabbit

  • Documentation
    • Added a new Plane AI Credits guide covering credit consumption, calculation factors, plan differences, rollover, top-ups, monitoring, fair use, and FAQs.
    • Updated billing docs to explain AI credits as a separate seat-based allocation distinct from workspace subscriptions and removed legacy trial details.
    • Updated documentation navigation to include the new Plane AI Credits page.

@vercel
Copy link

vercel bot commented Nov 12, 2025

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

Project Deployment Preview Comments Updated (UTC)
docs Ready Ready Preview Comment Nov 12, 2025 1:09pm

@coderabbitai
Copy link

coderabbitai bot commented Nov 12, 2025

Walkthrough

Adds a new Plane AI credits documentation page, replaces the former free-trial content with an "AI credits and usage" section in billing docs, and updates the sidebar to include the new credits page.

Changes

Cohort / File(s) Summary
New docs page
docs/ai/plane-ai-credits.mdx
New documentation describing Plane AI's credit system: consumption factors, plan differences, workspace pooling, credit lifecycle (rollover/top-ups), monitoring/alerts, exclusions, fair use, and FAQ.
Billing docs update
docs/workspaces-and-users/billing-and-plans.mdx
Replaced the "Free trial" subsection with "AI credits and usage"; removed 14-day trial flow and associated UI/content and added per-seat monthly credit allocation, depletion, rollover, and top-up explanations.
Sidebar/navigation
sidebars.ts
Added ai/plane-ai-credits to the AI category items and adjusted trailing formatting in the items array.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

  • Review docs/workspaces-and-users/billing-and-plans.mdx for any remaining references to the removed free trial flow and ensure wording is consistent with other billing docs.
  • Verify sidebars.ts entry integrates correctly and navigation renders the new ai/plane-ai-credits page.

Poem

🐰 I hopped through docs with notes so bright,
Credits counted by day and night.
Free trials folded into rhyme,
Seats and pools keep perfect time.
Read the page — the credits gleam,
AI hums on, a coder's dream.

Pre-merge checks and finishing touches

✅ Passed checks (3 passed)
Check name Status Explanation
Title check ✅ Passed The title 'Plane AI credits' clearly and concisely summarizes the main change: adding comprehensive documentation for the Plane AI credit system.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
✨ Finishing touches
  • 📝 Generate docstrings
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch ai-credits

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

@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

📜 Review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 162cd53 and 2d696d0.

📒 Files selected for processing (3)
  • docs/ai/plane-ai-credits.mdx (1 hunks)
  • docs/workspaces-and-users/billing-and-plans.mdx (1 hunks)
  • sidebars.ts (1 hunks)
🧰 Additional context used
🪛 LanguageTool
docs/ai/plane-ai-credits.mdx

[style] ~46-~46: Consider a different adjective to strengthen your wording.
Context: ...ucture for optimization (250 credits) | Deep analysis across multiple projects, with...

(DEEP_PROFOUND)


[grammar] ~101-~101: Ensure spelling is correct
Context: ... | $4.00 | Small active teams | | Scale ack | 5,000 | $9.00 | Moderate automation u...

(QB_NEW_EN_ORTHOGRAPHY_ERROR_IDS_1)

⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (1)
  • GitHub Check: Cursor Bugbot
🔇 Additional comments (11)
docs/ai/plane-ai-credits.mdx (9)

1-7: LGTM!

The front matter and imports are properly configured with clear metadata.


8-27: LGTM!

The introduction effectively explains the rationale for the credit system and clearly defines the three factors that influence credit consumption.


28-54: LGTM!

The consumption patterns are clearly illustrated with practical examples and well-structured tables that help users understand how credits map to real-world usage.


56-65: LGTM!

The plan comparison table provides a clear overview of credit allocations and policies across different tiers.


67-77: LGTM!

The workspace pooling explanation clearly articulates the rationale and provides a concrete example of how shared credits work in practice.


79-91: LGTM!

The credit lifecycle explanation is comprehensive, covering rollover policies for each plan tier and the FIFO usage strategy.


106-113: LGTM!

The explanation of non-credit-consuming actions is clear and sets appropriate expectations, especially the clarification that deleting content doesn't refund credits.


114-122: LGTM!

The fair usage and transparency features are well-designed, providing users with cost previews, automatic refunds for failures, and timely alerts.


124-192: LGTM!

The FAQ section comprehensively addresses common user questions with clear, detailed answers in an accessible collapsible format.

sidebars.ts (1)

306-311: LGTM!

The navigation changes correctly add the new AI credits documentation to the sidebar and clean up the formatting.

docs/workspaces-and-users/billing-and-plans.mdx (1)

60-65: LGTM!

The updated billing documentation clearly introduces the credit-based AI system and appropriately distinguishes it from the seat-based subscription model. The link to the detailed credits page provides users with a clear path to more information.

Copy link

@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: 0

♻️ Duplicate comments (1)
docs/ai/plane-ai-credits.mdx (1)

193-195: Verify the pricing page anchor exists.

The link on line 195 uses #ai-&-credits as the URL fragment. This issue was previously flagged but remains unresolved. The anchor may not exist on the pricing page, and the unencoded ampersand in the fragment could cause link failures depending on how the page is rendered.

Before merging, verify one of the following:

  1. If the anchor exists on the pricing page: Update the link to use the correct fragment (URL-encode the ampersand as %26 if the page's anchor-parsing requires it, or use the matching anchor ID exactly as defined on the target page).
  2. If no anchor exists: Remove the fragment and link to the top-level pricing page: https://plane.so/pricing

To verify, manually visit https://plane.so/pricing and inspect the HTML to confirm whether an anchor with id ai-&-credits or similar exists.

🧹 Nitpick comments (2)
docs/ai/plane-ai-credits.mdx (2)

6-6: Remove unused import.

The Tags component is imported but never used in the document.

Apply this diff to remove the unused import:

-import Tags from "@site/src/components/Tags";
-
 # How Plane AI credits work

46-46: Consider a stronger descriptor for the analysis task.

The phrasing "Deep analysis across multiple projects" is clear, but a more specific verb could strengthen the language (e.g., "Comprehensive analysis," "Multi-project audit," or "Detailed capacity assessment").

This is a minor enhancement and can be deferred if you prefer the current wording.

📜 Review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 2d696d0 and 3b528b8.

📒 Files selected for processing (1)
  • docs/ai/plane-ai-credits.mdx (1 hunks)
🧰 Additional context used
🪛 LanguageTool
docs/ai/plane-ai-credits.mdx

[style] ~46-~46: Consider a different adjective to strengthen your wording.
Context: ...ucture for optimization (250 credits) | Deep analysis across multiple projects, with...

(DEEP_PROFOUND)

⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (1)
  • GitHub Check: Cursor Bugbot
🔇 Additional comments (2)
docs/ai/plane-ai-credits.mdx (2)

8-104: Documentation content is well-structured and clear.

The explanations of the credit system, consumption factors, and pricing tiers are comprehensive and user-friendly. Table formatting is correct (including "Scale pack" on line 101), and the examples effectively illustrate how credits work in practice.


106-192: FAQs and supporting sections provide clear guidance.

The "What doesn't consume credits," fair usage transparency, and FAQ sections effectively address user concerns with concrete examples and straightforward language. The expandable details elements are properly formatted for accessibility.

@sriramveeraghanta sriramveeraghanta merged commit 78970de into master Nov 12, 2025
4 checks passed
@sriramveeraghanta sriramveeraghanta deleted the ai-credits branch November 12, 2025 13:13
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants