How it works.
Collaboration, made easy.

Add a comment layer to your running project. Share a link, review in context and bring Claude into the conversation when you need a hand.

Install Tonen

Choose Claude Code, Claude Desktop or Codex below and follow its installation instructions.

Sign in to Tonen in the browser and click Allow to connect your agent.

Return to your agent and start a new chat in your project. You only need to connect once.

Install now
In your terminal: install Tonen and sign in, once
claude plugin marketplace add tonenapp/tonen-plugin && claude plugin install tonen@tonen && claude mcp login plugin:tonen:tonen
Ask Claude to enable comments and get a share link for your project
Add Tonen to my project

Add Tonen to your project

Ask your connected agent: “Add Tonen to my project.” In Claude Code, you can also run /tonen:setup.

Your agent adds Tonen’s script tag. Open your running site and check that the Tonen bar appears.

Open the project in Tonen to manage where it runs and who can comment. Confirm a new address before sharing it with reviewers.

Share and choose who can comment

Open your project, choose the branch you want to review and select Invite people.

Choose Anyone who opens this site, Anyone with the share link, or Only people you add. Each branch has its own access setting.

For a share link, copy it when Tonen shows it and send it to your reviewers. Tonen shows the secret link only once.

For a private review, add reviewers by email. Reviewers sign in with their email to comment; they do not need a member account.

Read, reply and resolve

On the site, press C and click an element to leave a comment. On touch screens, use the comment tool in the bar.

Open a pin or the comment list to read the conversation. You can also find comments on your project’s Comments tab in Tonen.

Reply in the thread, check the result on the running project and resolve the comment when it is settled. Agents can help with fixes, but a person resolves the comment.

Review together, live

Open the same page with your reviewers. Press / and type to talk beside your cursor. Cursor chat disappears; use a comment for anything you want to keep.

Open the people in the bar and choose someone to follow. You follow their page, scroll position and open comment.

Scroll yourself to pause, choose Catch up to return, or Stop to explore on your own. Ask to follow invites others to follow you; each person decides.

Bring Claude into the conversation

Connect Claude Code using the installation instructions above, then ask Claude to listen for your Tonen comments on this project.

Keep that Claude Code session open. As a project member, mention @Claude in your own comment or reply.

Your listening Claude receives the comment and its place on the page. It can reply in the thread and asks for your approval before changing your site or code.

Add members and co-owners

As an owner, choose Invite people on your project. Enter the person’s Tonen account email and choose Member or Owner.

Members can help manage the project and its reviewers. Adding someone as a reviewer only gives them access to review.

As an owner, use the member’s menu to make them an owner too. Keep at least one owner on the project.

Connection and sharing help

Where do I run the installation command?

Run the command. We recommend your terminal, with the Claude Code or Codex CLI. In the Claude Code app, paste it in the chat and Claude runs it.

How do I connect Claude’s apps?

In Claude's apps. On the web, the desktop app or the phone, add the marketplace tonenapp/tonen-plugin under Customize, then Plugins. Claude can read and answer your comments there.

What do I do after signing in?

Sign in. Click Allow in your browser. When Codex shows Authentication complete. You may close this window., close that tab and go back to your agent.

Then start fresh. Wait for your agent to confirm the connection, then start a new chat in your project's repository.

What if sign-in does not start?

Sign-in didn't start? In Claude Code, type /mcp, choose plugin:tonen:tonen, then Authenticate. In Codex, run codex mcp login tonen.

What if I connected Tonen before?

Connected Tonen before? If you used claude mcp add, remove that connection first (claude mcp remove tonen): Claude Code keeps it and hides the plugin's.

Can I retrieve my share link later?

Save your share link. Tonen shows it only once.

Do reviewers need a Tonen account?

No. Reviewers sign in with their email before posting a comment. They can join wherever the project's access setting lets them in.

Choose anyone who opens the site, anyone with its share link, or only people you add. These settings belong to each branch, so you can review different versions with different people.

Does Tonen host my project?

Tonen adds a comment layer to the site you already run. Your deployed site needs to be online. When working locally, the Tonen CLI can share a local site with project members and reviewers you have added.

Which agents can I connect?

Claude Code, Claude Desktop and Codex. Mentions currently work with Claude only and are picked up by your connected Claude Code session while it is listening.

Who receives comment notifications?

Owners receive new comments by email; people who commented receive replies, unless they stopped those mails. Tonen groups notifications, so they may not arrive immediately.

Whose Claude receives a mention?

Mentions reach your own connected Claude, not another member’s. Codex can read and work on comments too; mentions currently work with Claude only.