Context links are time-bounded URLs that return your draft’s raw markdown content. They’re designed for AI agents — paste the link into Claude, ChatGPT, or any tool that can fetch URLs, and the agent gets the current text of your draft.
Context links are separate from link sharing. They don’t grant access to the Ramble app, don’t allow editing, and don’t create a WebSocket connection. They return plain text at a URL.
Creating a Context Link
Open the share panel and look for the “For AI agents” section. Choose an expiration duration:
| Duration | Use case |
|---|---|
| 1 hour | Quick, one-off agent interaction |
| 24 hours | Working session across a day |
| 7 days | Ongoing agent workflow |
Clicking a duration creates the link and copies it to your clipboard. Only the draft author can create context links.
You can also use the keyboard shortcut Cmd+Shift+L (Mac) or Ctrl+Shift+L (Windows/Linux). If a context link already exists, this copies it to your clipboard. If none exists, it opens the share panel.
What Agents Receive
When an agent fetches a context link, it receives:
- Content type:
text/markdown - Body: the raw markdown source of your draft, as-is
- No HTML, no UI, no metadata — the response is the document text
The URL format is https://app.ramble.md/ctx/:token. The token is an opaque string that identifies the link.
One Link at a Time
Each draft can have one active context link. Creating a new link automatically revokes the previous one. If you need to share with multiple agents, they can all use the same link — the limit is one link per draft, not one use.
Revoking a Link
Click Revoke in the share panel to immediately invalidate the link. Anyone (or any agent) that tries to fetch it after revocation gets a 404 response. Revoked links can’t be reactivated — create a new one instead.
Links also expire automatically at the end of their duration. Expired links behave the same as revoked ones.
How Context Links Differ from Link Sharing
These are independent systems with different purposes:
| Context Links | Link Sharing | |
|---|---|---|
| For | AI agents | People |
| Returns | Raw markdown text | Full Ramble editor UI |
| Access level | Read-only, always | View or edit (your choice) |
| Expires | After 1h, 24h, or 7d | Never (until you disable) |
| Connection | Single HTTP request | Persistent WebSocket |
Related
- Sharing & Access — link sharing and public access for people
- The Editor — what the raw markdown source looks like
- Limits — resource quotas and rate limits