Project Releases, Audit logs, editor blocks, widgets

docs/.vitepress/config.ts

@@ -412,7 +412,7 @@ if(n<200&&document.readyState==="loading")requestAnimationFrame(function(){bar(n
               },
             ],
           },
-          { text: "Workspace Audit logs", link: "/workspaces-and-users/audit-logs" },
+          { text: "Workspace Audit Logs", link: "/workspaces-and-users/audit-logs" },
           {
             text: "Billing and plans",
             collapsed: true,
@@ -456,6 +456,8 @@ if(n<200&&document.readyState==="loading")requestAnimationFrame(function(){bar(n
               { text: "Publish projects", link: "/core-concepts/deploy" },
             ],
           },
+          { text: "Project Audit Logs", link: "/projects/project-audit-logs" },
+
           {
             text: "Project States",
             link: "/core-concepts/projects/project-states",
@@ -539,9 +541,13 @@ if(n<200&&document.readyState==="loading")requestAnimationFrame(function(){bar(n
             link: "/core-concepts/projects/milestones",
           },
           {
-            text: "Releases",
+            text: "Workspace Releases",
             link: "/releases",
           },
+          {
+            text: "Project Releases",
+            link: "/projects/releases",
+          },
           { text: "Stickies", link: "/core-concepts/stickies" },
         ],
       },
@@ -595,6 +601,7 @@ if(n<200&&document.readyState==="loading")requestAnimationFrame(function(){bar(n
             ],
           },
           { text: "Page Templates", link: "/templates/page-templates" },
+          { text: "Edit MS Office Files", link: "/pages/edit-ms-office-files" },
         ],
       },
       {
@@ -734,6 +741,7 @@ if(n<200&&document.readyState==="loading")requestAnimationFrame(function(){bar(n
         items: [
           { text: "Plane AI", link: "/ai/plane-ai" },
           { text: "AI Skills", link: "/ai/ai-skills" },
+          { text: "AI Usage", link: "/ai/ai-usage" },
           { text: "AI credits", link: "/ai/plane-ai-credits" },
           { text: "MCP Connectors", link: "/ai/mcp-connectors" },
           {

docs/ai/ai-usage.md

@@ -0,0 +1,70 @@
+---
+title: AI usage
+description: Monitor how much Plane AI your workspace and its members consume each month, view usage trends and breakdowns, and understand your monthly allowance and limits.
+---
+
+# AI usage
+
+AI usage shows how much Plane AI your workspace consumes. It gives you a monthly meter, a usage trend over time, and a detailed breakdown of where AI is being used, so you can keep an eye on consumption and stay ahead of your monthly allowance.
+
+AI usage is read-only. It reports consumption, and it does not change any settings or data.
+
+## Where to find it
+
+Open Plane AI and use the sidebar to reach two screens:
+
+- **Usage** shows your monthly meter and usage trend.
+- **Analytics** shows a detailed breakdown of consumption.
+
+## Personal and workspace views
+
+Both screens have a **Personal** and a **Workspace** view:
+
+- **Personal** shows your own AI consumption. Any member can see this.
+- **Workspace** shows consumption across the whole workspace, including every member and any AI agents. Only **Admins** and **Owners** can see the Workspace view.
+
+## The Usage screen
+
+**Monthly meter.** A meter shows how much of your monthly allowance has been used in the current period. On Plane Cloud this is shown as a **percentage** of your allowance. The meter can read above 100% because the limit is applied after a request completes, not partway through it.
+
+**Reset date.** Below the meter, Plane shows where you are in the current cycle (for example, the day within the month) and the date the allowance **resets**. Allowances reset monthly.
+
+**Usage trend.** A chart plots consumption over time. You can switch the interval between **Week** and **Month** and move between periods to see how usage is changing.
+
+On self-hosted deployments, usage is measured in **tokens** rather than a percentage, and the Usage screen also shows total **tokens in** and **tokens out**.
+
+## The Analytics screen
+
+The Analytics screen breaks usage down so you can see exactly where AI is being spent. Choose a dimension to group by:
+
+- **Models** — which AI models were used
+- **Users** — consumption per member
+- **Agents** — consumption by AI agents
+- **Features** — which AI features were used (for example chat, page actions, or predictions)
+- **Projects** — consumption per project
+
+The breakdown is a table with the group's name, its **share of usage**, the **tokens used**, and the number of **requests**. The table is paginated, and you can **export** it to CSV for offline analysis.
+
+The Users, Agents, and Projects breakdowns are part of the Workspace view, so they require Admin or Owner access.
+
+## Your monthly allowance and limits
+
+Each workspace has a monthly AI allowance that depends on your plan. Consumption counts against that allowance during the billing month and resets at the start of the next one.
+
+- **Nearing your limit.** When you reach about 80% of your allowance, Plane shows a warning so you can plan ahead.
+- **Reaching your limit.** When the allowance is used up, Plane AI features are **paused** for that subject (a member or the workspace's agents) until the next monthly reset. The request that crosses the limit still finishes; the next one is blocked. You will see a message that AI capabilities are temporarily disabled until the reset date.
+
+Because the limit is applied after a request rather than partway through, your meter can briefly show slightly over 100%.
+
+For how allowances are assigned per plan, what overage does, and how billing works, see [Plane AI credits](/ai/plane-ai-credits).
+
+## Plane Cloud and self-hosted
+
+How usage is measured depends on where Plane runs:
+
+- **On Plane Cloud**, usage is shown as a **percentage** of a monthly allowance that scales with your plan. Members and AI agents each have their own allowance.
+- **On self-hosted deployments**, you connect your own AI provider, so **members are not metered**. Usage is reported in **tokens**, and only the shared pool used by AI agents is bounded, and only if your administrator has configured a token budget for it. If no agent budget is configured, agent features are unavailable rather than metered.
+
+## Availability
+
+AI usage is part of **Plane AI** and appears only where Plane AI is enabled for your workspace. If Plane AI is not enabled, the Usage and Analytics screens are not available. See [Plane AI](/ai/plane-ai) for how to enable it.

docs/ai/plane-ai-credits.md

@@ -1,70 +1,81 @@
 ---
 title: How Plane AI credits work
-description: Understand seat-based AI credits, what happens when included credits run out, and how workspace overage keeps your team moving.
+description: Understand how Plane AI credits work on Plane Cloud per-seat monthly allowances, what happens when they run out, workspace overage, and how to monitor usage.
 ---
 
 # Plane AI credits
 
-Plane AI credits measure AI usage in Plane Cloud.
+Plane AI credits measure how much Plane AI (Pi) your workspace uses on Plane Cloud. Your plan includes a monthly allowance, and AI features draw from it as your team uses them.
 
-::: warning IMPORTANT
-AI credits apply only to Plane Cloud.
+To see how much of your allowance you have used, open the [AI usage](/ai/ai-usage) dashboard. It shows your consumption for the current month as a percentage of your allowance.
 
-On self-hosted instances, you use your own AI provider [API key](https://developers.plane.so/self-hosting/govern/instance-admin#artificial-intelligence), and all AI usage and costs are managed directly through your provider.
+::: warning Credits apply only to Plane Cloud
+On self-hosted instances you connect your own AI provider [API key](https://developers.plane.so/self-hosting/govern/instance-admin#artificial-intelligence), so there are no Plane credits. All AI usage and costs are handled directly through your provider, and members are not metered by Plane.
 :::
 
 ## How credits are assigned
 
-Credits are included **per paid seat**.
+Credits are included with your plan and refresh every month.
 
-- Each active seat gets a monthly included credit amount based on your plan.
-- Included credits are account-level entitlements tied to seats.
-- This model is designed to be simple and predictable, similar to how modern AI products commonly package usage.
+- Each active paid seat gets a monthly included allowance based on your plan.
+- The allowance is an entitlement tied to seats, so your total capacity scales with your team.
+- Allowances reset at the start of each monthly billing period.
 
-For current included amounts by plan, check the latest pricing details on [Plane pricing](https://plane.so/pricing#ai-&-credits).
+AI **agents** draw from a separate, workspace-level allowance rather than from any one member's. Automated agent activity does not consume a person's individual credits.
 
-## No default pooling
+For current included amounts by plan, see [Plane pricing](https://plane.so/pricing#ai-&-credits).
 
-Plane AI credits are **not pooled by default**.
+## Credits are not pooled by default
 
-That means one member's unused included credits are not automatically shared across the rest of the workspace.
+Each member has their own monthly allowance. One member's unused credits are not automatically shared with the rest of the workspace. This keeps each person's available capacity predictable.
 
-## What happens when included credits run out
+## What happens when credits run out
 
-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.
+As a member approaches their allowance, at around 80% used, Plane shows a warning so they can plan ahead.
 
-Workspace admins can enable a workspace-level overage setting so teams can continue using AI after included credits are exhausted.
+When the allowance is fully used for the month, what happens depends on whether workspace overage is enabled:
+
+- **Overage off (the default).** Plane AI features pause for that member until the allowance resets at the start of the next month. The request that reaches the limit still finishes, and the next one is paused. The member sees a message that AI is temporarily unavailable until the reset date.
+- **Overage on.** AI keeps working past the included allowance, and the additional usage is billed at the workspace level.
+
+The same applies to the workspace's agent allowance: agents pause when it is used up, unless overage is enabled.
 
 ## Workspace overage
 
-When workspace overage is enabled:
+Overage is a workspace-level setting that keeps your team moving after included credits are used up.
+
+- When enabled, AI usage continues past the included allowance.
+- The additional usage is billed to the workspace.
+- Workspace admins decide whether to allow it, so cost stays in your control.
 
-- AI usage continues after included credits are consumed.
-- Additional usage is billed at the workspace level.
-- Admins stay in control of whether overage is allowed.
+If overage is off, AI pauses at the limit until credits reset or more capacity is added to the workspace.
 
-If overage is disabled, new AI actions are paused after included credits are exhausted until credits reset or additional capacity is purchased/enabled.
+## Monitor usage
 
-## Tracking and controls
+Track consumption from the [AI usage](/ai/ai-usage) dashboard:
 
-Plane provides usage visibility so admins can manage cost and adoption:
+- A **monthly meter** shows how much of the allowance has been used, as a percentage.
+- A **usage trend** chart shows how consumption changes over time.
+- An **analytics breakdown** shows where AI is being used, by member, feature, project, model, and agent.
 
-- Current credit balance and consumption trends
-- Workspace-level usage monitoring
-- Billing visibility for additional usage when overage is enabled
+Every member can see their own usage. Workspace admins and owners can also see workspace-wide usage.
 
 ## FAQs
 
 ::: details Are credits shared automatically across all users in my workspace?
-No. Plane does not use automatic credit pooling by default.
+No. Credits are not pooled by default. Each member has their own monthly allowance.
 :::
 
 ::: details Do I get credits for each seat?
-Yes. Included credits are assigned per paid seat based on your plan.
+Yes. An included allowance is assigned per paid seat based on your plan. AI agents draw from a separate, workspace-level allowance.
 :::
 
 ::: details Can we keep using AI after included credits are used up?
-Yes, if a workspace admin enables overage at the workspace level.
+Yes, if a workspace admin enables overage. Otherwise, AI pauses for that member until the allowance resets at the start of the next month.
+:::
+
+::: details How do I see how much AI we have used?
+Open the [AI usage](/ai/ai-usage) dashboard. It shows your usage as a percentage of your allowance, along with trends and a breakdown by member, feature, project, model, and agent.
 :::
 
 ::: details Where can I see the latest included credit amounts?