# \#docs

**URL:** https://forum.cursor.com/tag/docs/323.md

[Latest](https://forum.cursor.com/latest.md) · [Categories](https://forum.cursor.com/categories.md) · [Tags](https://forum.cursor.com/tags.md)

---

## [Table's sorting bug on official Cursor webpage (cursor.com/docs)](https://forum.cursor.com/t/tables-sorting-bug-on-official-cursor-webpage-cursor-com-docs/175006)

<div class="topic-metadata">

**Author:** [@Przemyslaw\_Karcz](https://forum.cursor.com/u/Przemyslaw_Karcz)\
**Replies:** 2\
**Last updated:** [October 16, 2026, 8:50am UTC](https://forum.cursor.com/t/tables-sorting-bug-on-official-cursor-webpage-cursor-com-docs/175006 "2026-10-16T08:50:52Z")

</div>

Where does the bug appear (feature/product)? Somewhere else… Describe the Bug There is a bug with sorting the tables on model’s pages on Cursor’s webpage. Steps to Reproduce Go into GPT-5.6 Sol | Cursor Docs Try to so…

---

## [BYOK usage counts against "Other Models" quota, contradicting the API keys doc](https://forum.cursor.com/t/byok-usage-counts-against-other-models-quota-contradicting-the-api-keys-doc/171794)

<div class="topic-metadata">

**Author:** [@Stone\_Sargent](https://forum.cursor.com/u/Stone_Sargent)\
**Replies:** 2\
**Last updated:** [October 9, 2026, 2:23pm UTC](https://forum.cursor.com/t/byok-usage-counts-against-other-models-quota-contradicting-the-api-keys-doc/171794 "2026-10-09T14:23:22Z")

</div>

Where does the bug appear (feature/product)? Cursor IDE Describe the Bug When using my own API key via the OpenAI API Key field with “Override OpenAI Base URL”, the resulting usage is still counted under the “Other Mode…

---

## [vscode.cursor.plugins.registerPath non-existent](https://forum.cursor.com/t/vscode-cursor-plugins-registerpath-non-existent/160334)

<div class="topic-metadata">

**Author:** [@wr8tt5](https://forum.cursor.com/u/wr8tt5)\
**Replies:** 4\
**Last updated:** [October 2, 2026, 11:37am UTC](https://forum.cursor.com/t/vscode-cursor-plugins-registerpath-non-existent/160334 "2026-10-02T11:37:48Z")

</div>

Where does the bug appear (feature/product)? Cursor IDE Describe the Bug The Cursor AI documentation at Extension API reference | Cursor Docs mentions two Cursor API calls for managing custom agent plugin search paths, …

---

## [Please align Slack integration docs with Marketplace scope list (User + Bot)](https://forum.cursor.com/t/please-align-slack-integration-docs-with-marketplace-scope-list-user-bot/173288)

<div class="topic-metadata">

**Author:** [@T.H](https://forum.cursor.com/u/T.H)\
**Replies:** 2\
**Last updated:** [September 29, 2026, 9:23am UTC](https://forum.cursor.com/t/please-align-slack-integration-docs-with-marketplace-scope-list-user-bot/173288 "2026-09-29T09:23:33Z")

</div>

Summary Our security team uses the Slack integration permissions docs when approving the Cursor Slack app. That page only lists 18 bot scopes. On the Slack Marketplace → Security & Compliance tab, I also see 30 User Toke…

---

## [Can't use cursor agent with ssh](https://forum.cursor.com/t/cant-use-cursor-agent-with-ssh/171811)

<div class="topic-metadata">

**Author:** [@IPCDSP\_2](https://forum.cursor.com/u/IPCDSP_2)\
**Replies:** 8\
**Last updated:** [September 28, 2026, 4:40pm UTC](https://forum.cursor.com/t/cant-use-cursor-agent-with-ssh/171811 "2026-09-28T16:40:48Z")

</div>

Where does the bug appear (feature/product)? Cursor IDE Describe the Bug Bug Report: Agent unusable over Remote-SSH when the remote host has no outbound internet (new cursor\_agent\_host topology) Request ID: 72503d9d-e46…

---

## [Duplicate Bot - Missing?](https://forum.cursor.com/t/duplicate-bot-missing/172938)

<div class="topic-metadata">

**Author:** [@Ja\_We](https://forum.cursor.com/u/Ja_We)\
**Replies:** 2\
**Last updated:** [September 26, 2026, 1:32pm UTC](https://forum.cursor.com/t/duplicate-bot-missing/172938 "2026-09-26T13:32:07Z")

</div>

Long-lived Grok Bots get expensive because each turn re-reads the full history. The documented workaround was Duplicate (handoff summary → Duplicate → Hide the original). Staff previously pointed at sidebar right-click a…

---

## [Expose customization settings for inline Markdown Preview](https://forum.cursor.com/t/expose-customization-settings-for-inline-markdown-preview/159934)

<div class="topic-metadata">

**Author:** [@SidSethi](https://forum.cursor.com/u/SidSethi)\
**Replies:** 5\
**Last updated:** [September 18, 2026, 4:42pm UTC](https://forum.cursor.com/t/expose-customization-settings-for-inline-markdown-preview/159934 "2026-09-18T16:42:46Z")

</div>

Feature request for product/service Cursor IDE Describe the request Summary Cursor has two built-in Markdown preview modes, but only the classic side preview appears to have supported customization settings. The inline…

---

## [Slack Assistant pane: every message spawns a new cloud agent, with no way to follow up on an existing one](https://forum.cursor.com/t/slack-assistant-pane-every-message-spawns-a-new-cloud-agent-with-no-way-to-follow-up-on-an-existing-one/165947)

<div class="topic-metadata">

**Author:** [@SeanCorc](https://forum.cursor.com/u/SeanCorc)\
**Replies:** 2\
**Last updated:** [September 14, 2026, 10:49am UTC](https://forum.cursor.com/t/slack-assistant-pane-every-message-spawns-a-new-cloud-agent-with-no-way-to-follow-up-on-an-existing-one/165947 "2026-09-14T10:49:39Z")

</div>

Where does the bug appear (feature/product)? Cloud Agent (GitHub, Slack, Web, Linear) Describe the Bug When using Cursor through Slack’s AI Assistant pane (the app’s side panel, not a channel), every message I send insi…

---

## [Shared Canvases dashboard is personal-only while docs and changelog promise team-wide discovery](https://forum.cursor.com/t/shared-canvases-dashboard-is-personal-only-while-docs-and-changelog-promise-team-wide-discovery/171343)

<div class="topic-metadata">

**Author:** [@Stefan\_Eilers](https://forum.cursor.com/u/Stefan_Eilers)\
**Replies:** 1\
**Last updated:** [September 13, 2026, 8:33am UTC](https://forum.cursor.com/t/shared-canvases-dashboard-is-personal-only-while-docs-and-changelog-promise-team-wide-discovery/171343 "2026-09-13T08:33:46Z")

</div>

Where does the bug appear (feature/product)? Cursor IDE Describe the Bug Publish on a canvas is documented as team sharing. In practice, teammates cannot discover published canvases at all. The Shared Canvases dashboar…

---

## [Admin API Docs Missing includedSpendCents and New Teams Usage Metrics](https://forum.cursor.com/t/admin-api-docs-missing-includedspendcents-and-new-teams-usage-metrics/162742)

<div class="topic-metadata">

**Author:** [@keshav-k3](https://forum.cursor.com/u/keshav-k3)\
**Replies:** 2\
**Last updated:** [September 9, 2026, 9:56am UTC](https://forum.cursor.com/t/admin-api-docs-missing-includedspendcents-and-new-teams-usage-metrics/162742 "2026-09-09T09:56:20Z")

</div>

Where does the bug appear (feature/product)? Somewhere else… Describe the Bug Summary The Teams Admin API documentation for “Get Spending Data” appears to be outdated and does not match the actual response returned by P…

---

## [Which model does Auto-review use](https://forum.cursor.com/t/which-model-does-auto-review-use/169516)

<div class="topic-metadata">

**Author:** [@Yoan\_Babulkov](https://forum.cursor.com/u/Yoan_Babulkov)\
**Replies:** 3\
**Last updated:** [September 8, 2026, 7:36am UTC](https://forum.cursor.com/t/which-model-does-auto-review-use/169516 "2026-09-08T07:36:06Z")

</div>

The docs say haiku 4.5 or gpt 5.4-mini Run Modes | Cursor Docs. If that’s really the case, why not use newer, cheaper and more intelligent models like gpt 5.6 luna instead?

---

## [Docs say to restart a Cloud Agent, but where is the restart option?](https://forum.cursor.com/t/docs-say-to-restart-a-cloud-agent-but-where-is-the-restart-option/170532)

<div class="topic-metadata">

**Author:** [@ColemanDunn](https://forum.cursor.com/u/ColemanDunn)\
**Replies:** 1\
**Last updated:** [September 4, 2026, 7:39am UTC](https://forum.cursor.com/t/docs-say-to-restart-a-cloud-agent-but-where-is-the-restart-option/170532 "2026-09-04T07:39:45Z")

</div>

Where does the bug appear (feature/product)? Cloud Agent (GitHub, Slack, Web, Linear) Describe the Bug The Cloud Agents docs, under “My secrets aren’t available to the cloud agent,” say: Try restarting the cloud agent…

---

## [How do you import Rules in the latest Rules settings](https://forum.cursor.com/t/how-do-you-import-rules-in-the-latest-rules-settings/170505)

<div class="topic-metadata">

**Author:** [@Mark\_Klimp](https://forum.cursor.com/u/Mark_Klimp)\
**Replies:** 1\
**Last updated:** [September 3, 2026, 10:22pm UTC](https://forum.cursor.com/t/how-do-you-import-rules-in-the-latest-rules-settings/170505 "2026-09-03T22:22:58Z")

</div>

Per this conversation, importing rules from github is the best practice. In this latest Rules Setting section from the Customize section I cannot figure out how to do it. My existing projects still import the rules but I…

---

## [When the agent waits on a backgrounded shell (the AwaitShell-style tool, protobuf case awaitToolCall), that wait is invisible to every public observability surface. The SDK explicitly maps awaitToolCall to null in the interaction-update converter, and the](https://forum.cursor.com/t/when-the-agent-waits-on-a-backgrounded-shell-the-awaitshell-style-tool-protobuf-case-awaittoolcall-that-wait-is-invisible-to-every-public-observability-surface-the-sdk-explicitly-maps-awaittoolcall-to-null-in-the-interaction-update-converter-and-the/170426)

<div class="topic-metadata">

**Author:** [@TaoJiang](https://forum.cursor.com/u/TaoJiang)\
**Replies:** 0\
**Last updated:** [September 3, 2026, 6:18am UTC](https://forum.cursor.com/t/when-the-agent-waits-on-a-backgrounded-shell-the-awaitshell-style-tool-protobuf-case-awaittoolcall-that-wait-is-invisible-to-every-public-observability-surface-the-sdk-explicitly-maps-awaittoolcall-to-null-in-the-interaction-update-converter-and-the/170426 "2026-09-03T06:18:04Z")

</div>

Feature request for product/service @cursor/sdk (TypeScript, local/self-hosted agents) + Agent hooks Describe the request Summary: when the agent waits on a backgrounded shell (the AwaitShell-style tool, protobuf case a…

---

## [Docs about GitLab integration incorrectly state that Self-Managed requires Premium or Ultimate](https://forum.cursor.com/t/docs-about-gitlab-integration-incorrectly-state-that-self-managed-requires-premium-or-ultimate/170293)

<div class="topic-metadata">

**Author:** [@tkskto](https://forum.cursor.com/u/tkskto)\
**Replies:** 2\
**Last updated:** [September 3, 2026, 5:36am UTC](https://forum.cursor.com/t/docs-about-gitlab-integration-incorrectly-state-that-self-managed-requires-premium-or-ultimate/170293 "2026-09-03T05:36:59Z")

</div>

The GitLab integration documentation currently states: GitLab integration requires a paid GitLab plan (Premium or Ultimate). Project access tokens, which are required for this integration, are not available on GitLab F…

---

## [How to set terminal profile?](https://forum.cursor.com/t/how-to-set-terminal-profile/170024)

<div class="topic-metadata">

**Author:** [@shahjigar](https://forum.cursor.com/u/shahjigar)\
**Replies:** 1\
**Last updated:** [September 2, 2026, 5:00pm UTC](https://forum.cursor.com/t/how-to-set-terminal-profile/170024 "2026-09-02T17:00:27Z")

</div>

How do I set the Terminal Profile (zsh, bash, etc.)? I am following the doc here, but it doesn’t match the Cursor UI. Version: 3.18.9 (Universal) VS Code Extension API: 1.128.0 Commit: 2ba48ff3f7514cc4643c52ca9f7b31…

---

## [Local marketplace \\ plugins testing](https://forum.cursor.com/t/local-marketplace-plugins-testing/169532)

<div class="topic-metadata">

**Author:** [@Barys\_Biankouski](https://forum.cursor.com/u/Barys_Biankouski)\
**Replies:** 1\
**Last updated:** [August 26, 2026, 12:46pm UTC](https://forum.cursor.com/t/local-marketplace-plugins-testing/169532 "2026-08-26T12:46:18Z")

</div>

Where does the bug appear (feature/product)? Cursor IDE Describe the Bug Plugins | Cursor Docs the instruction here is absolutely not working on Cursor 3.17.19 Steps to Reproduce What we see in the documentation: Test…

---

## [Broken link for "slash command" in Subagents docs](https://forum.cursor.com/t/broken-link-for-slash-command-in-subagents-docs/159459)

<div class="topic-metadata">

**Author:** [@jitendravyas](https://forum.cursor.com/u/jitendravyas)\
**Replies:** 2\
**Last updated:** [August 26, 2026, 11:49am UTC](https://forum.cursor.com/t/broken-link-for-slash-command-in-subagents-docs/159459 "2026-08-26T11:49:32Z")

</div>

Where does the bug appear (feature/product)? Somewhere else… Describe the Bug Hi Cursor team, On the Subagents docs page ( Subagents | Cursor Docs ), in the “Anti-patterns to avoid” section, there is this bullet: “Dup…

---

## [Docs contradict each other on what Fork Chat copies (3.17.19)](https://forum.cursor.com/t/docs-contradict-each-other-on-what-fork-chat-copies-3-17-19/169458)

<div class="topic-metadata">

**Author:** [@Steve\_Carlisle](https://forum.cursor.com/u/Steve_Carlisle)\
**Replies:** 1\
**Last updated:** [August 25, 2026, 6:24pm UTC](https://forum.cursor.com/t/docs-contradict-each-other-on-what-fork-chat-copies-3-17-19/169458 "2026-08-25T18:24:42Z")

</div>

Where does the bug appear (feature/product)? Cursor IDE Describe the Bug This is a documentation defect. The docs give two incompatible descriptions of what Fork Chat copies, and they imply opposite outcomes for the sam…

---

## [Does Logging Into GrokBot Count as a Separate Computer?](https://forum.cursor.com/t/does-logging-into-grokbot-count-as-a-separate-computer/169289)

<div class="topic-metadata">

**Author:** [@Guangjian\_Zhang](https://forum.cursor.com/u/Guangjian_Zhang)\
**Replies:** 3\
**Last updated:** [August 24, 2026, 9:34am UTC](https://forum.cursor.com/t/does-logging-into-grokbot-count-as-a-separate-computer/169289 "2026-08-24T09:34:47Z")

</div>

This is not a billing or refund question. I’m trying to understand Cursor’s device-identification behavior and whether it is documented anywhere. I recently noticed that simply logging into GrokBot appears to affect Cur…

---

## [User Rules - Docs are not explicit, AI agent misinterpretsthem](https://forum.cursor.com/t/user-rules-docs-are-not-explicit-ai-agent-misinterpretsthem/168764)

<div class="topic-metadata">

**Author:** [@BigBlock\_Studios](https://forum.cursor.com/u/BigBlock_Studios)\
**Replies:** 3\
**Last updated:** [August 23, 2026, 12:09pm UTC](https://forum.cursor.com/t/user-rules-docs-are-not-explicit-ai-agent-misinterpretsthem/168764 "2026-08-23T12:09:39Z")

</div>

Trying to create a rule for the agents conversational tone, the rules docs around “User Rules” are vague at best. they do not explicitly state that there is no directory ~/.cursor/rules. When asked to create a user r…

---

## [Add cache life info](https://forum.cursor.com/t/add-cache-life-info/169093)

<div class="topic-metadata">

**Author:** [@Artemonim](https://forum.cursor.com/u/Artemonim)\
**Replies:** 0\
**Last updated:** [August 21, 2026, 5:03pm UTC](https://forum.cursor.com/t/add-cache-life-info/169093 "2026-08-21T17:03:17Z")

</div>

Please add the cache read TTL information to the table.

---

## [Help Center is wrong about User Rules being local to \*this machine\*](https://forum.cursor.com/t/help-center-is-wrong-about-user-rules-being-local-to-this-machine/168642)

<div class="topic-metadata">

**Author:** [@AMDphreak](https://forum.cursor.com/u/AMDphreak)\
**Replies:** 1\
**Last updated:** [August 17, 2026, 1:07pm UTC](https://forum.cursor.com/t/help-center-is-wrong-about-user-rules-being-local-to-this-machine/168642 "2026-08-17T13:07:57Z")

</div>

Where does the bug appear (feature/product)? Somewhere else… Describe the Bug Where does the bug appear (feature/product)? Docs / Help Center: Rules | Cursor Docs Describe the Bug The “Where are rules stored?” sectio…

---

## [Docs.cursor.com/llms.txt serves an HTML page instead of the llms.txt file](https://forum.cursor.com/t/docs-cursor-com-llms-txt-serves-an-html-page-instead-of-the-llms-txt-file/167800)

<div class="topic-metadata">

**Author:** [@portdeveloper](https://forum.cursor.com/u/portdeveloper)\
**Replies:** 2\
**Last updated:** [August 13, 2026, 11:25am UTC](https://forum.cursor.com/t/docs-cursor-com-llms-txt-serves-an-html-page-instead-of-the-llms-txt-file/167800 "2026-08-13T11:25:05Z")

</div>

Where does the bug appear (feature/product)? Somewhere else… Describe the Bug the docs domain migration broke cursor’s llms.txt for anyone holding the old URL. https://docs.cursor.com/llms.txt redirects to https://curso…

---

## [Official nesting depth for subagents — how deep is reliable in current Cursor?](https://forum.cursor.com/t/official-nesting-depth-for-subagents-how-deep-is-reliable-in-current-cursor/167883)

<div class="topic-metadata">

**Author:** [@e.spinu](https://forum.cursor.com/u/e.spinu)\
**Replies:** 2\
**Last updated:** [August 10, 2026, 1:08pm UTC](https://forum.cursor.com/t/official-nesting-depth-for-subagents-how-deep-is-reliable-in-current-cursor/167883 "2026-08-10T13:08:58Z")

</div>

Hi Cursor team, I’m designing multi-agent workflows and want to confirm the intended and reliable nesting depth for subagents in the latest Cursor (IDE + CLI if they differ). What docs say today Subagents FAQ states t…

---

## [Cursor Docs AI Assistant Error "AI Gateway authentication failed: Invalid API key"](https://forum.cursor.com/t/cursor-docs-ai-assistant-error-ai-gateway-authentication-failed-invalid-api-key/167757)

<div class="topic-metadata">

**Author:** [@bifoc34610](https://forum.cursor.com/u/bifoc34610)\
**Replies:** 1\
**Last updated:** [August 8, 2026, 1:30pm UTC](https://forum.cursor.com/t/cursor-docs-ai-assistant-error-ai-gateway-authentication-failed-invalid-api-key/167757 "2026-08-08T13:30:55Z")

</div>

Where does the bug appear (feature/product)? Somewhere else… Describe the Bug The following content was automatically generated by AI. Issue Description: When attempting to use the AI assistant on the Cursor documenta…

---

## [Cursor Docs AI Assistant Error: "AI Gateway authentication failed: Invalid API key"](https://forum.cursor.com/t/cursor-docs-ai-assistant-error-ai-gateway-authentication-failed-invalid-api-key/167723)

<div class="topic-metadata">

**Author:** [@bifoc34610](https://forum.cursor.com/u/bifoc34610)\
**Replies:** 1\
**Last updated:** [August 7, 2026, 8:45pm UTC](https://forum.cursor.com/t/cursor-docs-ai-assistant-error-ai-gateway-authentication-failed-invalid-api-key/167723 "2026-08-07T20:45:27Z")

</div>

The following content was automatically generated by AI. Issue Description: When attempting to use the AI assistant on the Cursor documentation site, the request fails and returns an API authentication error. Error Ou…

---

## [Detailed changelog](https://forum.cursor.com/t/detailed-changelog/167718)

<div class="topic-metadata">

**Author:** [@Evgeniy\_OZ](https://forum.cursor.com/u/Evgeniy_OZ)\
**Replies:** 0\
**Last updated:** [August 7, 2026, 5:40pm UTC](https://forum.cursor.com/t/detailed-changelog/167718 "2026-08-07T17:40:09Z")

</div>

Feature request for product/service Describe the request Please consider publishing a more detailed changelog that includes all user-visible changes, not just the major ones. For example, it would have helped me know …

---

## [What do Agent AI Stats (Today) and Tab AI Stats actually measure?](https://forum.cursor.com/t/what-do-agent-ai-stats-today-and-tab-ai-stats-actually-measure/167109)

<div class="topic-metadata">

**Author:** [@k31](https://forum.cursor.com/u/k31)\
**Replies:** 4\
**Last updated:** [August 4, 2026, 6:10am UTC](https://forum.cursor.com/t/what-do-agent-ai-stats-today-and-tab-ai-stats-actually-measure/167109 "2026-08-04T06:10:40Z")

</div>

After updating to Cursor 3.13.25 I noticed two new status bar metrics: Agent AI Stats (Today) Tab AI Stats (Today) I couldn’t find any documentation explaining what they represent. Here are my observations: • Agent …

---

## [Unclear how to add MCP to cloud env](https://forum.cursor.com/t/unclear-how-to-add-mcp-to-cloud-env/166993)

<div class="topic-metadata">

**Author:** [@jonasms](https://forum.cursor.com/u/jonasms)\
**Replies:** 2\
**Last updated:** [July 31, 2026, 6:14pm UTC](https://forum.cursor.com/t/unclear-how-to-add-mcp-to-cloud-env/166993 "2026-07-31T18:14:12Z")

</div>

Where does the bug appear (feature/product)? Cloud Agent (GitHub, Slack, Web, Linear) Describe the Bug I need to attach a custom HTTP MCP (Superhuman Mail: https://mcp.mail.superhuman.com/mcp) so Cloud Agents can use em…

[Next page](https://forum.cursor.com/tag/docs/323.md?match_all_tags=true&page=1&tags%5B%5D=docs)
