Cursor · Advanced

Context management

Use @ mentions when you know what's relevant, read the context ring, choose a model and window size, and keep tangents in side chats.

Cursor context management

What fills the window

It's more than your messages. The breakdown tray lists the system prompt, tool definitions, rules, skill descriptions, MCP catalogs, subagent docs, summaries and the conversation itself. Part of that loads in every chat before you type a word. Look at a brand-new chat once to see your baseline.

What happens when it fills up

Cursor compresses older parts of the conversation into a summary, so the chat can continue. That's helpful, but summaries drop detail. If a constraint matters for the rest of the session, restate it or put it in a rule. If a chat has gone wrong, a new one with a short handoff usually beats pressing on.

Frequently asked
How do I see how much context I've used in Cursor?

Look at the context ring next to the prompt input. Click it to open a tray showing total tokens split by category, and hover over a row to highlight that category.

What can I @-mention in Cursor?

Files and folders, @Terminals, @Chats, @Browser, and Git diffs with @Commit and @Branch. You can also mention rules, and side chats.

Does Cursor still have @Codebase and @Docs?

Cursor's current @ mention lists don't include them. Agent searches your code and the web with its own tools, so ask your question in plain words.

What is a side chat in Cursor?

It's a separate conversation attached to a parent agent, opened with /side or /btw. It can see the parent's history as hidden context, while its own messages stay out of the main thread unless you @-mention it.