Agent links

An agent link returns a draft’s raw markdown text at a URL. Paste it anywhere a tool can fetch a URL (Claude, ChatGPT, an agent framework, a CLI) and the tool reads the current text of your draft.

This is separate from publishing a page (see Sharing & access). An agent link does not grant access to the Ramble app or the editor. It returns plain text only.

Open the Share controls on a draft. Under Agent link, choose how long the link should last under Link expires in: 1h, 24h, or 7d. Choosing a duration creates the link and copies it to your clipboard.

Only the draft’s author can create an agent link.

What an agent receives

The link returns the raw markdown source, served as text/markdown. No HTML, no app interface, no metadata. A tool that fetches the link gets the same characters you see in the editor.

A draft has one active agent link. Creating a new one revokes the previous link, so the old URL stops working the moment the new one exists.

The limit is one link per draft, not one use. Several agents can fetch the same link at once.

While an agent link is active, anyone who has the link can read the draft until the link expires. Hand it out the way you would hand out a published link.

Revoke an agent link to invalidate it immediately. After you revoke it, or after it expires, fetching the link returns nothing: a 404 response.

A revoked or expired link cannot be reactivated. Create a new one when you need access again.

Both hand out read access at a link with no sign-in, and they serve different readers.

Agent linkPublished page
ForAI agents and toolsPeople
ReturnsRaw markdown textA read-only web page
ExpiresAfter 1h, 24h, or 7dWhen you unpublish
Sign-inNoneNone
  • Sharing & access: publish a read-only page and control who can see a draft
  • The AI assistant: Ramble’s built-in assistant, which works inside the editor and is separate from an agent link
  • The editor: the markdown source an agent link returns