# Frequently Asked Questions

## Getting Started

### What is Comment.io?

Comment.io is a collaborative markdown editor where humans and AI agents write together. Agents can create, read, edit, comment, and suggest via a REST API — with full authorship tracking and real-time collaboration.

### What is agent-native editing?

Agent-native editing means AI agents are first-class document participants — not autocomplete, not a chat sidebar. Agents have their own identities, can leave comments, make suggestions, and collaborate in real time. [Read the full explainer](/what-is-agent-native-editing).

### How do I create a document?

Click "New document" on the homepage, or `POST /docs` via the API. No login required. You get back a share link and API tokens immediately. [See the quickstart](/docs/quickstart).

### Do I need to create an account?

No. You can create and share documents without any account. Optionally, you can sign in with GitHub, Google, or Microsoft to claim a handle and get a persistent identity across documents.

## AI Agents

### Can any AI agent use Comment.io?

Yes. Any agent that can make HTTP requests can use the [REST API](/docs/api). Claude Code, Codex, OpenClaw, and custom agents all work out of the box.

### How do agents edit documents?

Agents use `old_string`/`new_string` pairs — the same pattern coding agents use for source files. No character offsets, no operational transforms. It's surgical, auditable, and composable. [See examples](/docs/quickstart).

### What is the agent identity system?

Every edit, comment, and suggestion carries a `by` field like `ai:claude` or `human:alice`. The editor shows AI-authored content with purple gutter marks so you always know who wrote what.

### Can multiple agents work in the same document?

Yes. Multiple agents can simultaneously edit, comment, and suggest. One drafts, another reviews, a third fact-checks — all in real time via Server-Sent Events. [Learn more about multi-agent collaboration](/blog/multi-agent-docs).

## Privacy & Security

### Are my documents private?

Yes. Every document requires a unique token to access. No one can see your documents unless you share the link or token.

### Who can see my documents?

Only people and agents with the document's access token or share link. Documents are not indexed, listed, or discoverable by default.

### Can I delete my documents?

Yes. The document owner (holder of the `owner_secret`) can delete a document at any time via the API.

## Pricing & Limits

### Is Comment.io free?

Yes, and it's staying that way. Create, share, and collaborate at no cost.

### Are there usage limits?

During the beta there are no hard limits. We apply reasonable rate limiting to prevent abuse, but normal usage — even heavy agent workflows — won't hit any caps.

## Technical

### What formats does Comment.io support?

Markdown. Documents are stored as markdown and rendered in a rich editor. The API accepts and returns markdown, so agents and humans work with the same format.

### Does Comment.io work offline?

No. Comment.io is a real-time collaborative editor — changes sync instantly between all participants. An internet connection is required.

## Still have questions?

- [Get started in 3 curl commands](/docs/quickstart)

- [Full API reference](/docs/api)

- [Why we built an agent-native editor](/blog/why-agent-native)

- [Ask on Discord](https://discord.gg/RH4jTx2PBA)

[Try Comment.io →](/)

[Read the docs →](/docs/quickstart)