--- title: "A few things you might be wondering" description: "Here’s how Comment works for you, your team, and your agents." canonical: "https://comment.io/faq" last-updated: 2026-10-15 --- # A few things you might be wondering Here’s how Comment works for you, your team, and your agents. ## What is Comment? Comment is a shared workspace where your team and its agents work from the same apps, docs, context and skills. Your team gets custom apps built for its workflow, a shared library of skills and knowledge, and a collaborative editor to catch up on, discuss and change what agents do. Agents work with all of it as fast and easily as with local files. ## Who is Comment for? Teams that want everyone to benefit from agents, not only the people who are already experts. One person can set up a skill, a source of truth or an app, and the whole team and its agents can use it. ## How do agents work with Comment? Agents read, search, and edit files as they would locally: using shell commands. A supported SSH, MCP, or HTTP connection provides a restricted set of commands to search, read, edit, and query. ## What is a skill? A skill is a short document of instructions for a task your team repeats, such as how to write a customer update or triage a bug. Comment tells every connected agent about the workspace’s skills and asks it to read the current version when a task matches. Anyone on the team can improve a skill in the editor. ## What is Doc DB? With Doc DB, a project document can have an owner, a status, and a due date. You decide the structure, and Comment checks that every update follows it. You can then query those fields to find overdue projects or build a live dashboard. It’s a document you can read and edit, and a database record you can rely on. ## Does every document automatically become a database record? No. You or your agent define the structure and create or update records to follow it. Ordinary documents can remain ordinary documents. Queries read the defined fields of typed records, rather than treating every sentence in a document as database data. ## Can apps update records? Yes. Queries read records, and a workspace app can also update them as the person using it, within that person’s access. A workspace owner can require approval before pages change records. ## Can I switch agent providers and keep the context? Yes. Your workspace documents and structured records remain in Comment when you change the agent provider you use. Connect another compatible agent, approve its access, and point it at the relevant work. Different clients support different connection methods. This does not transfer private chats or a provider’s internal memory, and it does not guarantee that every agent uses the context in the same way. ## What should I start with? Pick something you want to move forward: a draft, a plan, a research question, or a document that needs another look. Ask your connected agent to do that work in Comment. You can start with one document and add context as you need it. ## Do I need to bring all my documents over? No. Start with the task in front of you and the documents it needs. You can keep using your other tools and bring more work into Comment when it’s useful. ## Which agents can I use? An agent needs a supported way to connect. Shell-capable agents can use SSH. Apps that support compatible remote MCP servers can use MCP. Programs can also use the HTTP API. Follow the [agent setup instructions](https://comment.io/llms.txt) for the connection that fits your agent or app. ## Does Comment provide the agent? You can bring a compatible agent from another app or environment. Its provider’s requirements and charges are separate. Comment also includes a workspace assistant, Doc. It is on in new workspaces, and a workspace owner can turn it off in Settings. Doc sends its conversations and the workspace content it reads to OpenAI. See the [privacy policy](https://comment.io/privacy) for how this works. ## How do I connect an agent? Start with the [agent setup instructions](https://comment.io/llms.txt). For SSH, the agent requests access and a person approves it in the browser. For MCP, add Comment’s server in a compatible app and approve the connection. The HTTP API has its own token setup instructions. You can see connected agents on the workspace’s Team page and disconnect them there. ## Who can see the work? Members and connected agents share the content in their workspace. When an agent reads content, it can send that content to its app and provider under their terms. Disconnecting an agent stops future access; it does not recall copies the agent already has. See the [privacy policy](https://comment.io/privacy) for details. ## Does Comment train AI models on our work? No. Comment doesn’t make its own models and never uses your workspace content to train AI models, so we have no reason to lock you into one model. Agents you connect send what they read to their own provider, and that provider’s terms decide how it uses that content. The built-in assistant, Doc, uses OpenAI, and a workspace owner can turn it off. See the [privacy policy](https://comment.io/privacy). ## What can a connected agent do? Agents can read, search, create, edit, rename, and remove workspace documents. They can define and update typed records, query their fields, comment, reply, and propose suggested edits. Each connected agent has its own identity in the workspace. Connect agents you trust with that access. If you want to review a change before it lands, ask your agent to propose a suggestion. ## Do I approve every edit? Approving an agent’s connection gives it workspace access. It can then make direct edits; Comment does not require you to approve each one. An agent can instead propose a suggested edit for you to accept or reject. Tell it which approach you want for the task. ## Can we work on the same document at the same time? Yes. People and connected agents can work on a shared document while it is open in the browser. Comment applies an agent’s text changes to the shared document so you can keep working together. ## How do I give my agent feedback? Comment on a passage or add a suggested edit. Ask your agent to read the feedback and revise. It can answer in the thread and propose changes of its own. A teammate can join the same discussion. ## Will my agent remember this next time? The documents and discussions stay in the workspace for authorized people and agents to read. Ask your agent to read the relevant files when it starts the next task. Keeping a decision in Comment makes it available as context; the agent still needs to use it. ## What kinds of work can I keep here? Comment supports Markdown documents, images, and HTML pages, with Mermaid diagrams in documents. Supported office files and text-based PDFs can be imported as Markdown. Conversion can change the formatting, and scanned PDFs need another way to extract their text. See the [file and import instructions](https://comment.io/llms/commands.md) for supported formats and limits. ## Can I get my documents out? Yes. You can copy documents out as Markdown. An agent connected over SSH can copy files out with scp or sftp. Keep the related images with them when you want to use the documents elsewhere. ## Do the workspace commands run on my computer? The restricted commands an agent sends to Comment run on Comment’s servers, within the connected workspace. That environment does not provide an arbitrary program runner or outbound network access. The agent’s own app or environment may separately use tools on your computer or other services. ## Is Comment free? Comment is currently free to use. Access is opening gradually through the waitlist. ## How do I get access? Join the waitlist on the [homepage](https://comment.io/). We’ll email you when you can get started. If you already have access, [log in](https://comment.io/login). ## Where can I ask another question? Email [support@comment.io](mailto:support@comment.io) or join the [Comment Discord](https://discord.gg/RH4jTx2PBA). ## Ready to work together? [Join the waitlist](https://comment.io/) [Log in](https://comment.io/login)