Exploring Cursor: Accessing External Documentation using @Doc
Switching between tabs to check documentation breaks my flow. I am deep in the code, need a quick reference, and somehow lost in an endless search.
I was live-streaming with my friend Ray when he introduced me to this feature that Cursor index external documentation directly!
Cursor lets you add external documentation links directly to your workspace. You just provide a link, and Cursor indexes it. Then, you can use it right there by typing @Doc
or mentioning the document's name.
Setting Up Docs in Cursor
During the live session, I decided to set up the AIProxy docs to see how well this feature worked. The link I used was for Replicate Swift examples:
Here is how you do it:
- Open Cursor and go to Settings.
- Click on the "Features" tab, then select "Docs."
- Add the new documentation link, and let Cursor do its thing.
To make sure it is indexed, click on the index button again for the green dot prefixed by the name of the document:
Once it indexed the link, I could access that documentation anytime by using @Doc
or directly typing out the name.
I wanted to see how smoothly it worked, so I opened the Composer and typed in @Doc
to pull up the information from AIProxy. The response was instant!
Moving Forward
The @Doc
feature reduced the friction of searching for information. It does keep me in the flow, letting me work without constant interruptions. I wonder how much of a difference it is when working with @Web
vs @Doc
but as long as it solves the problem quickly, it does not matter. If you frequently bounce between your editor and browser for a particular set of documentation, try setting up a few docs in Cursor
Happy Cursoring!