---
title: "Collaboration | Kalka docs"
description: "Share a document in a live room, follow someone, leave comments on layers, ask an agent in a thread, and mark frames ready for development."
url: https://kalka.design/docs/collaboration
language: en
---

## Rooms

A room lets several people work on the same document at the same time. Kalka connects your computers directly to each other: no server keeps a copy of the file, and nobody needs an account.

### Share

Click the share button in the top bar and choose **Share this file**. Kalka copies a link such as `https://kalka.design/share/…`. Send it to the people you want to work with.

### Join

- Open the link. On a computer with Kalka, it offers to open the room in the desktop app; otherwise it opens in the browser.

- Or paste the link or the room ID in **Join room…** on Home, or in the share panel.

The room opens in its own tab.

A room only opens while someone who has the file is online. Until then Kalka shows that it is waiting for them.

### What you share

Edits, images and variables sync as you work. Everyone sees the others’ cursors and selections, with their names, and the agents working in the document, with what they are doing. Prompts sent to agents are never shared.

**Leave room** keeps a copy of the document on your computer.

To hide other people’s cursors, turn off **View › Multiplayer Cursors**.

## Follow someone

Click a person’s avatar in the top bar and choose **Follow**: your view moves with theirs. Press Esc, or move the view yourself, to stop. Agents can be followed the same way.

## Comments

Press C, or click **Comment** in the toolbar, then click a layer or a spot on the canvas. Write your comment and post it. A comment pinned to a layer moves with it.

- Pins rest as small dots so the design stays in view, and grow when you point at them.

- Shift C shows or hides all pins.

- The **Comments** panel in the left rail lists **Open** and **Resolved** threads. **Resolve** closes a thread and removes its pin; **Reopen** brings it back.

Comments are saved with the document. They are not part of undo, so undoing a change never removes a comment.

### Ask an agent in a thread

Write `@agent`, or the agent’s name such as `@Pebble`, in a comment. The agent reads the thread and the layers it is pinned to, does the work, and answers in the thread. The **Agents** tab of the Comments panel shows what each agent is doing, and the **Changes** tab lists what it changed, with **Restore before this**.

## Ready for development

Right-click a top-level frame and choose **Mark ready for dev** to tell developers it is done. If anyone changes the frame afterwards, it shows that it changed since approval and needs another review. **Move to draft** takes the mark off.
