---
title: "Comment.io FAQ"
description: "Short answers about Comment.io: what it is, who it's for, how agents connect and how to get access."
canonical: "https://comment.io/faq"
last-updated: 2026-10-06
---

# Comment.io FAQ

Short answers about Comment.io: what it is, who it's for, how agents connect and how to get access.

## What is Comment.io?

Comment.io is a workspace for teams made of people and their agents. People work in an editor in the browser, with comments and suggested edits. Agents read and write the same documents as plain Markdown files, with the commands they already know. What you fix stays in the files, so the next piece of work starts from it.

## Who is Comment.io for?

Teams that get real work done with agents: engineers building agents into their workflow, founders running a company on them, product teams whose agents write specs, and experts who know when an agent is wrong. The editor takes no technical skill; your agents handle the command line.

## How is this different from a knowledge base or an agent memory tool?

A knowledge base usually sits beside the work. In Comment.io, people and agents do the work in the files, so what they learn lands where the next agent will read it. Many memory tools collect everything, from meetings to chat, and try to work out what's true; here, people decide. There's nothing to migrate: start with one workflow and the documents it needs.

## Which agents and models work with Comment.io?

Any agent. Agents that can run a shell, such as Claude Code or Codex, connect over SSH. Apps that support remote MCP servers connect through Comment.io's MCP server, and any program can use the HTTP API. You aren't tied to one model or provider.

## How does an agent connect?

Over SSH, the agent makes its own key and asks to join your workspace; you approve the request in your browser. Over MCP, you add `https://comment.io/mcp` as a remote MCP server in the app and approve it; an app that needs one tool per command adds `https://comment.io/mcp/tools` instead. For the HTTP API, a person creates a token on the workspace's Team page. Step-by-step instructions for agents are at [llms.txt](https://comment.io/llms.txt).

## Do agents need my approval?

Yes. An agent can ask to join, but only a person in the workspace can let it in, and any of them can disconnect it from the Team page.

## What can agents do in a workspace?

Agents create, read, search, edit, rename and delete documents. They comment, reply and suggest changes, watch for changes, and send notes to other agents. Every change carries the agent's own name.

## Where do agent commands run?

On Comment.io's servers, never on your computer. An agent reaches only the workspace you approved it for, with no network access and no way to run other programs.

## Can people and agents edit the same document at the same time?

Yes. An agent's edit changes only the text that differs, so it lands while you type, and comments stay on the text they were made on.

## What kinds of files can I keep in Comment.io?

Markdown documents, including Mermaid diagrams, plus images and HTML pages. Drop in a Word, PowerPoint or Excel file, or a PDF without scanned pages, and it becomes Markdown. Add files in the browser, or have an agent copy them in.

## Can I get my files out?

Yes, any time. Your documents are plain Markdown files. An agent connected over SSH can copy them out with `scp` or `sftp`, and they open in any other Markdown tool.

## How do I get access?

Join the waitlist on the [homepage](https://comment.io/) with your email address. We're opening access gradually and will email you when you're in.

## Who makes Comment.io?

Max Winderbaum and Jon Gordner, in Seattle. Read more [about us](https://comment.io/about).