Clarabit changelog
Product updates from the Clarabit team.
-
Feature 2026-11-04 · Nov 4, 2026
November 4, 2026 — Streams that sort your work, a Home that says what needs you, and clearer factory runs
Streams that sort your work, a Home that says what needs you, and clearer factory runs
November 4, 2026
Clarabit now sorts every task and page into its stream, so work for one product, client or system stays together without anyone filing it by hand. Home opens on what needs you, with a chat to ask about your work. Every task says what to do next. Needs you asks less and says more plainly what it wants. And a factory run now reads top to bottom: what went in, what came out, and how it ran.
New: Clarabit sorts your work into streams
Why you should care: work for one product, client or system ends up scattered across titles and projects, and sorting it by hand never happens. Now Clarabit does it as the work comes in.
A stream is a line of work people follow as one thing: a product, a client or a system. Each task and page sits in one stream.
- Filed as it's created: every new task and page goes into its stream, whether it was made on the web, from your AI app or by a factory. Clarabit says why ("Its title starts with Rufus", "Its spec page is in Rufus"). When the name doesn't settle it, an AI model reads the title and description to pick one. When Clarabit isn't sure, it leaves the work unsorted.
- Kept tidy: once a day, Clarabit files older work it hasn't sorted yet, writes a one-line description for any stream without one, and suggests new streams or merges. You decide on each suggestion in Settings → Streams.
- Make new streams without asking: a project can let Clarabit make the new streams it's sure of and file the work into them. It's off unless someone turns it on in Settings → Streams. Merging two streams always waits for you.
- Streams look different from labels: a stream shows as a coloured dot with its name, and labels stay as pills. A task's stream has its own row in Details, with a picker to change it or clear it.
Filing is on for every project. To turn it off for a project, open Settings → Streams.
New: Home opens on what needs you
Why you should care: the first screen should answer "what do I need to do?", not make you go looking.
- Needs your attention and Running now sit at the top of Home.
- Ask about your work: the chat at the bottom of Home answers in plain words. Try What needs me?, My week or What's running, or tell it what you're working toward. Earlier conversations that still have a decision waiting show a count, so you know which one to come back to.
- The map, when you want it: press Map to see your factories as a town and watch runs move through them. Press Dashboard to go back.
- The old dashboard is now Activity, in the sidebar.
New: every task says what to do next
Why you should care: a task that sits still usually needs one decision. Now Clarabit names it.
Each task has a Next step box: what to do and why, for example Check it's still needed: close it or hand it off. Nothing has happened on it for 3 weeks. From the box you can claim the task, start it in Codex or Claude Code, or copy a prompt for any AI app.
Improved: Needs you asks less, in plainer words
- Plain names: every item says what it is: Agent question, Approval, Factory run to accept, Spec to approve, Work to review or Check on staging.
- Finished work says so: when a task's merge request was merged, or its last comment says it's done, the item says so and suggests closing it instead of asking again.
- Dismissed means dismissed: an agent question you dismissed no longer comes back when the agent checks in.
Improved: factory runs that read top to bottom
- In, Out, How it ran: a run page shows what went in, what came out, and then how it ran, in that order. It's the same in the side panel, and each fact appears once.
- A failed run says why: a cloud run that stops says what went wrong in one sentence and what to do about it, and marks the step it stopped at, for example Stopped at step 2 (Draft the update).
- Make a factory by hand: in Factories → New factory, choose Make it here. Fill in a name, what it's for, a project and the steps. Clarabit saves a draft for you to review and publish, the same as one proposed from your AI app.
Fixes
- The Tasks and Pages lists show the latest changes when you come back to them with the browser's Back button.
- A cloud factory run reads your connections only when the run is yours: scheduled for you, or started by you. A run requested by a teammate or another factory gets no access to your Google data, and nobody's connections are read after they leave the workspace.
- Check on staging can only be approved for a task that is actually on staging.
- Text a factory run writes keeps its formatting but no longer carries images or styling from the run's inputs.
Connector update
The cloud connector and the local MCP package are both on 2.19.0, so this release also works inside ChatGPT and Claude:
- Streams in your AI app: ask for a project's stream map to see each stream, what's in it and what waits on you. Ask your AI app to sort a project and it runs the same Sort now pass as Settings → Streams. Accept or dismiss stream suggestions right in the chat.
- Clarabit's next step in chats: when your AI app shows you a task, a run or something that needs you, it offers Clarabit's next step in one line and acts on it only after you say yes.
- Links from cards open Clarabit signed in: Open in Clarabit on a card takes you straight to the page, without a sign-in screen.
- More from the card: approve a spec, a code review or a check on staging; choose Not now or Close task on something in Needs you; and comment on a page.
If the new tools or cards don't appear, reconnect Clarabit in your AI app.
-
Feature 2026.10.28 · Oct 28, 2026
October 28, 2026 — Your work tools in your AI app, Clarabit inside ChatGPT and Claude, and cloud factory runs
Your work tools in your AI app, Clarabit inside ChatGPT and Claude, and cloud factory runs
October 28, 2026
Your AI app can now read the tools your work lives in, as you: Google Chat, Docs and Calendar, Granola, Attio and Intercom. In ChatGPT and Claude, Clarabit's tasks, pages and runs now appear as cards you can act on right in the chat. Clarabit can also run a factory for you in the cloud, using those same sources. And the app has a new layout that's quicker to move around.
New: your AI app can read your work tools through Clarabit
Why you should care: the context for most work isn't in your chat. It's in last week's meeting, a Google Doc, a Chat thread or a customer record. Now your AI app can pull that in through Clarabit, as you, without copying and pasting.
Open Connections from the workspace menu:
- Google Chat and Docs: connect your own Google account. Your AI app can then list and search your Chat spaces, read messages (including the files, cards and links people share), and read any Doc you can open.
- Google Calendar meetings: your AI app can list your meetings for a date range, with the meeting notes attached to each.
- Granola: add your own Granola API key. Your AI app can read your meeting notes, and the transcript when you ask for it.
- Attio (a workspace owner connects it once): your AI app can search and read records, notes, tasks and list entries. A task linked to an Attio record shows the record's name, stage and owner, and changes to that record appear in the task's activity.
- Intercom (Fin) (a workspace owner connects it once): your AI app can search and read support conversations. A task linked to a conversation shows it inline.
Connections are read-only. Clarabit doesn't store what it reads, and each person's Google and Granola access stays their own. Members with access to only some projects can't read the workspace's Attio or Intercom data.
New: see and act on Clarabit inside ChatGPT and Claude
Why you should care: checking a task or accepting a run used to mean leaving the chat for the Clarabit app. Now the work comes to you.
When your AI app shows you a task, a page, a factory run or what needs you, it appears as a live card in the conversation. From the card you can claim a task, add a comment, or accept or reject a run, without leaving the chat. Ask your AI app to "open Clarabit" for a home view of what needs you, your projects and your tasks. In ChatGPT, Clarabit also appears in the sidebar.
Cards appear in AI apps that support interactive views, currently ChatGPT and Claude. Other apps, like Codex and Cursor, keep working as before, with text answers.
New: Clarabit can run a factory for you
Why you should care: some routines shouldn't have to wait for someone to open their AI app. A Monday brief should be ready on Monday.
A factory's owner can now switch it to Clarabit runs it, pick a model, and press Run now, or let its schedule start runs. Each cloud run shows what it cost. Running from your own AI app stays free.
The person a factory is assigned to can let its cloud runs read their connections (Google Chat, Docs and Calendar, and Attio) from the factory's Setup tab. Only that person can turn this on. Runs never write, and every read shows on the run page as evidence, so you can see where each fact came from.
New: briefs that read like a report, not a wall of text
Factories and AI apps can now write a page as a structured brief: headline numbers, callouts, tables of tasks that stay up to date, sources, and checks. It's easier to scan, and it still exports as plain text for sharing and email.
To find past briefs, use the new date filter in Pages. Pick a day, or a range, to see the pages created then, grouped by day. A page made by a factory says which run produced it and whether that run was accepted.
Improved: a redesigned app
- A new layout: a left sidebar for your workspaces and your work, with the same headers, tabs and filters on every screen.
- Jump anywhere: press Cmd+K to go to any task, page, factory or project.
- Look without leaving: pages, runs, factories and attention items open in a side panel from any list. Use
j/kto move between rows andoto open the full page. - Your work or everyone's: lists now have a people switch at the top. They open on Mine, which shows work assigned to you. Switch to Everyone to see the whole workspace; Clarabit remembers your choice.
- Tasks by due date: filter Tasks by past due, due in the next 7 days, or no due date.
Improved: merge requests and pull requests stay with the work
Paste a GitLab merge request or GitHub pull request link on a task and Clarabit recognizes it, showing the repository and number. When an AI app finishes a factory run that produced one, the link is saved on the run and on its task.
Fixes
- A task can only be assigned to someone who can open its project.
- Task links must be a complete web address (http or https).
- When a connected service fails, your AI app now gets the actual reason instead of a generic error.
- A factory's overview no longer shows the name of a hand-off factory in a project you can't see.
Connector update
The cloud connector and the local MCP package are both on 2.15.4, with read tools for Google, Granola, Attio and Intercom, the in-chat views, and support for structured briefs. If the new tools or cards don't appear, reconnect Clarabit in your AI app. See the MCP changelog for what changed in each connection type and how to update.
-
Feature 2026.10.20 · Oct 20, 2026
October 20, 2026 — Factories, dark mode, and project-level access
Factories, dark mode, and project-level access
October 20, 2026
This release adds factories: your team's repeatable routines, saved once so your AI app runs them the same way every time. It also adds dark mode, a dashboard that starts with what needs you, and a way to give someone access to only the projects they need.
New: Factories — run your team's routines the same way every time
Why you should care: the useful things you ask an AI app to do each week, like a status update, a research summary or a customer brief, depend on someone remembering the right prompt, sources and checks. A factory saves all of that once. Anyone on the team gets the same quality of result, and you only step in to accept it.
A factory is a saved recipe: the inputs it needs, the steps to follow, the checks the result must pass, and where the result goes. Ask your AI app (Claude, ChatGPT, Codex or Cursor) to run it. The app reports each step back to Clarabit as it works. When it's done, the factory's owner accepts the result or rejects it with a reason. Recipes are versioned, so changes are reviewed before they apply.
- Request a run yourself, put one on a schedule, or share a public form so people outside your workspace can ask for one.
- Hand work along: a factory can pass its result to another factory. For example, accepting a research run can queue the writing factory next.
- See it all: the Factories map shows your factories, the AI apps that run them and what they produce. The Factories guide explains every recipe option and how to test a factory before you rely on it.
To start, ask your AI app to "propose a factory for our weekly status update", or open Factories in Clarabit.
New: dark mode
Every screen now works in dark mode. Use the theme toggle in the navigation to choose system, light or dark. Clarabit remembers your choice and applies it before the page appears, so you don't get a white flash.
Improved: start with what needs you
Why you should care: when you open Clarabit, the first question is "what's waiting on me?" Now that's the first thing you see.
- Dashboard: a Needs your attention list sits at the top, next to what's running now. Blockers and runs to accept come first, and the top item is marked Next.
- Task page: one card holds the next step: the blocker to answer, or the buttons to launch the task in your AI app. The details sit below it.
- Attention details: what you're asked to do, and what will clear the item, come first. The evidence reads as plain words instead of raw data.
New: give someone access to just the projects they need
Workspace owners can now invite a restricted member, who sees only the projects you choose. This is useful for a contractor, client or partner. Change their projects, or lift the restriction, at any time from Workspace settings. Their AI app sees the same limits.
Fixed: private files stay private
Uploads and attachments now check access every time they're opened. Someone who was removed from your workspace, or who never belonged to it, can't open a private file from an old link. Shared pages and published release notes still show their images.
Connector update
The cloud connector and the local MCP package are both on 2.8.0, which adds the factory tools. See the MCP changelog for details and how to update.
-
Feature 2026.09.20 · Sep 21, 2026
September 20, 2026 — New task launches, Attention, and self-serve workspaces
New task launches, Attention, and self-serve workspaces
September 20, 2026
This release helps you spend less time preparing task prompts and checking where work needs your input. New task launches give you a starting prompt, Attention brings requests and blockers together, and project templates give your AI apps shared instructions to work from. You can also invite others to try Clarabit in their own workspace with a signup link.
New: get from a task to working on it faster
When you’re ready to work on a task, you no longer have to write the opening request from scratch. The new launch actions prepare a prompt for that task that you can open in a supported AI app or copy into an existing conversation. Review it, add anything you want, and send it when you’re ready.
Use it to start an article outline, investigate a question, plan your week, or work on code. Writing, research, and planning projects can use the same flow without a code repository.
Launch controls on a coding task. Choose an app or copy the prompt into your conversation.
New: see where your input can move work forward
When you’re checking in on several pieces of work, start with the new Attention view. It brings review requests, reported blockers, and sessions that appear to have stopped into one place, so you can find what needs a decision without opening each task to check.
Each item explains why it is there and links to the task or session. Clarabit distinguishes a reported request for help from detected inactivity, helping you decide whether to review a result, answer a question, or check on work that may have stopped.
New: give each project a useful starting point
Project instruction templates reduce the blank-page work of explaining how you want an AI app to help. Choose a starting set of shared instructions for the kind of work you’re doing; connected AI apps can read them when they load the project, giving them a common starting point across conversations.
Templates are chosen per project. Your writing project can start with different instructions from your coding project, so you can organize different kinds of work without forcing them to use the same setup.
New: an easier way to introduce others to Clarabit
If you’ve wanted to share how you use Clarabit with a colleague or friend, you can now send them this signup link and let them try it in their own workspace. They can sign in with Google and get started without waiting for us to create an account for them.
Guided setup walks them through creating a project, choosing a template, and connecting their AI app, so you don’t have to walk them through every setup step yourself.
Guided setup lets new users choose the AI app they want to connect first.
To collaborate in your existing workspace, continue using teammate invitations.
Session tracking: new capabilities and reliability fixes
- Hosted session reporting: AI apps using the hosted MCP connector can now report session progress.
- Clearer identity: session details distinguish the person or account behind the work from the AI runtime being used.
- More reliable activity tracking: active sessions and task claims stay current as your AI app works with Clarabit, and stopped sessions are detected more consistently.
Fixes to existing features
- Page history: the latest saved version is now included and retrievable. Change summaries on new edits are attached to the version they describe.
- Task links: links returned to AI apps use the correct Clarabit web address, and task context includes linked merge requests.
- Release timestamps: corrected time handling for release-note publication.
Connector update
Both the cloud connector and local MCP package are now on 2.7.0. See the MCP changelog for the local/cloud comparison and upgrade instructions.
-
Feature 2026.08.03.1 · Aug 3, 2026
Release v2026.08.03.1
This follow-up release completes the task-identifier rollout for agent integrations and includes a small package-security refresh.
🤖 Use recognizable task identifiers from MCP tools
Clarabit MCP tools now accept the same human-friendly task references used in the app. Agents can use canonical references such as CLA-288, lowercase variants such as cla-288, or hyphenless variants such as CLA288 wherever a task reference is supported.
Numeric database IDs remain compatible, and responses continue to return the canonical uppercase, hyphenated identifier.
🔖 See the correct MCP version
The MCP server now reports its installed package version during initialization instead of returning a stale hardcoded value. This makes diagnostics and client compatibility checks clearer.
📄 Keep page-version history lightweight
Listing a page’s version history now returns metadata only. Full historical content is fetched only when an agent asks for a specific version, reducing payload and token usage for long-lived pages.
🛡️ Dependency maintenance
MCP package 2.6.0 also includes current production dependency security fixes.
No action is required for the Clarabit web app. Agent installations that pin package versions should update to
@limeadelabs/clarabit-mcp@2.6.0. -
Feature 2026.08.03 · Aug 3, 2026
Release v2026.08.03
This release makes work easier to reference, projects easier to navigate, and agent instructions easier to keep current. Here’s what’s new.
🔖 Give every task a durable, recognizable identifier
Tasks now use readable identifiers such as CLA-27 or COM-42 instead of a global database number.
An identifier series belongs to your workspace and can be shared by several projects. That means teams that use projects for initiatives, epics, or sprints can keep one continuous product sequence across all of them.
You can now:
- search by an identifier with or without its hyphen;
- copy a task’s identifier or canonical link from the task page;
- follow consistent task links from boards, dashboards, agent sessions, notifications, and reports; and
- choose an existing series or create a new one when you create a project.
Existing numeric links and supported integrations remain compatible, so saved bookmarks and established workflows continue to work.
🧭 Move through a project without losing your place
Project pages now share one persistent navigation shell. Tasks, Pages, Agent Context, Environments, Time Reports, and Settings stay in a consistent project section instead of competing for space in a crowded action bar.
The new layout keeps project context visible, makes management actions easier to find, and adapts cleanly across desktop, tablet, and narrow screens.
🤖 Keep agent instructions current in one place
Agent Context is now the durable source for project and workspace instructions.
Clarabit assembles those instructions in a consistent order for agent bootstrap and task context, while Project Settings provides a compiled preview rather than a second editable copy. Existing project instructions are carried forward, and current integrations remain compatible.
This reduces drift between repositories and Clarabit, and gives Codex, Claude Code, Cursor, OpenClaw, and other supported harnesses the same starting context.
🏷️ Set up the right kind of project from the start
The New Project form now lets you choose between:
- Internal projects, which track time without billing controls; and
- Consulting projects, which add billable flags and billable/non-billable reporting.
Internal remains the default. You can also see what each choice changes before creating the project.
✨ A few thoughtful improvements
- Form fields now have consistent, comfortable spacing throughout Clarabit.
- Project actions remain readable and usable at narrower widths.
- Task links, references, and search results consistently return the canonical uppercase, hyphenated identifier.
- Identifier keys use clear letter-only mnemonics and preserve historical references if a key is renamed.
-
Feature 2026.07.30 · Jul 31, 2026
Release v2026.07.30
This release helps your team keep project knowledge current, review important decisions with confidence, and give AI helpers the right access. Here's what's new.
✅ Review the active spec right from the page
When a page is attached as a task's active spec, you can now see its review status from both the task and the page.
Reviewers can approve the spec or request changes without leaving the document, so feedback stays close to the work. Clarabit also keeps a clear record of who reviewed it, when they reviewed it, and which version was approved.
AI helpers can ask for a review, while the final decision stays with a person.
🗄️ Tidy up old pages without losing them
Have a page that's no longer current? You can now archive it instead of deleting it. Add a quick reason and, if helpful, point people to a newer page.
Archived pages:
- remain available by direct link;
- stay out of normal search and AI context;
- guide readers to a replacement page when one is provided; and
- can be restored whenever you need them.
Archived projects also stay out of your everyday dashboards and summaries while remaining available when you need to look back.
🔐 Give an AI helper access to just one project
You can now create credentials for an entire workspace or limit them to one project. Project access is a simple way to give an AI helper only the information it needs.
For added peace of mind, a new secret is shown only once when you create it. After that, Clarabit keeps a short, safe prefix to help you recognize the credential—not the reusable secret itself. Your existing credentials will keep working, and you can revoke access at any time.
📎 See uploaded files where the conversation happens
Attachments now appear right on the task page. Images include an inline preview, and other files include helpful download details.
Files added to a comment appear directly beneath that comment, making it easier to keep screenshots, documents, and feedback together.
🛠️ A few helpful fixes
- Revoking a pending workspace invitation now works reliably.
- Archived projects and pages no longer add outdated information to dashboards or AI context.
- Credential security is stronger, with no need to reconnect your existing integrations.
🤖 Using Clarabit with AI helpers?
Project-specific credentials work with supported AI clients including Codex, Claude Code, and Cursor. You'll see setup instructions as soon as you create a credential, while the secret is still visible.
If your Clarabit MCP integration is pinned to a version, update to
@limeadelabs/clarabit-mcp@2.5.0or later for the latest page archiving and attachment workflows. -
Feature v2026.05.22 · May 22, 2026
Release v2026.05.22
Six improvements you can use today.
✨ Attach a spec page to a task
When editing a task, pick a project page as its canonical spec from a dropdown. The selected spec shows up on the task view with a direct link — so anyone reading the task can jump straight to the design doc, decision log, or whatever else informs the work. Clear the field to detach.
Agents can do the same via
cla_update_task(task_id, spec_page_id)in clarabit-mcp v2.4.0+ (nullclears the attachment).🔁 Resend a workspace invitation
Owners can now resend a pending invitation with one click — no more revoke-and-re-invite dance. The token rotates (the old email link stops working), the expiry resets to 7 days, and a fresh email goes out. Look for the new Resend action next to Revoke in workspace settings → Invitations.
🩹 Anchor staleness banner is honest now
Page comments anchored to a substring used to show the "This text has been edited or removed" banner on perfectly intact pages — false alarm caused by missing version data on older comments. Fixed: the banner now only appears when the page has genuinely drifted past the comment's anchor (the page version moved AND the anchor text is no longer in the body).
🎨 Mermaid diagrams render unicode correctly
—,→,•, and other multi-byte characters in mermaid node labels no longer turn into mojibake (â€",•). Drop them straight into your architecture diagrams — no—/→/•workarounds needed.🖼️ Agents can upload screenshots inline (MCP)
@limeadelabs/clarabit-mcp@2.4.0ships three new upload tools:cla_upload_image— upload PNG/JPG/GIF/WebP (up to 5 MB) and get back a markdown snippet ready to paste into a comment bodycla_upload_task_attachment— task-scoped attachments (up to 10 MB; PDF and text also accepted)cla_upload_comment_attachment— comment-scoped attachments
The workhorse is
cla_upload_image. Agents can now take a Playwright screenshot, upload it, and post a comment with the image embedded inline — all in one round trip.🏷️ Agents can manage labels (MCP)
Also in clarabit-mcp v2.4.0:
cla_list_labels,cla_add_label_to_task, andcla_remove_label_from_task. Attach by label name (auto-creates within the task's project if missing) or by label id. Agents can drive label-based workflows — UAT needed, blocked, needs-spec — without bouncing through the web UI.
Upgrading the MCP: the new tools live in
@limeadelabs/clarabit-mcp@2.4.0. If your install is pinned to a specific version, bump to2.4.0(orlatest) and restart your editor's MCP host to pick up the new tools. -
Feature v2026.05.17 · May 18, 2026
Release v2026.05.17
Release v2026.05.17
✨ What's new in Clarabit
Share pages with anyone — they don't need a Clarabit account. Mint a public link from any page and send it to a teammate, customer, or stakeholder. They review the page and leave comments; their feedback shows up in your normal page-comment view with an "External" badge. They verify their email once via a magic-link; after that, follow-up comments post instantly. Revoke any link from the page header whenever you're done.
In-product release notes. This page. Click "🎉 What's new" in the top nav (or the green dot when there's something new) and a drawer slides in with the latest updates. Also public at clarabit.ai/changelog.
🤖 What's new for your AI helper
If you use Clarabit through an AI helper like Claude Cowork, Claude Code, or Codex, today's update teaches it three new things.
Leave a comment on a specific phrase in a page. Ask your AI to "leave a comment on the third bullet under Risks" and it'll land exactly there. If the phrase shows up in more than one spot, your AI will surface the candidates and ask which one you meant — no more silently anchoring to the wrong place.
Read the existing discussion on a page. Ask "what's still open on this spec?" or "summarize the comments on the launch plan" and your AI can pull up the unresolved feedback (or all of it) without you copy-pasting.
Save shared context for the team. When you tell your AI about a project convention or constraint — "we deploy on Tuesdays, never Fridays" — it can now save that into Clarabit so the next person, or your next AI session, picks it up automatically.
🔄 Heads-up: these AI features only show up after your AI helper picks up the latest version of the Clarabit MCP connector. Most tools refresh automatically when you restart them; a few need a manual "Update tools" nudge in their settings. Technical users, the exact commands are in For agents and integrators below.
🐛 Fixed
- Pages with comments from removed teammates no longer crash.
- Agent comments stay clean — internal AI-tool tags (the "<system-reminder>…" kind) get stripped automatically before the comment is saved.
- Adding a link to a task works with either shape the API accepts — the older "flat" payload no longer 500s.
For agents and integrators
The rest of this changelog is for folks driving Clarabit through MCP, an API integration, or building on top of the platform. If that's not you, you can stop reading here.
⚠️ Update your Clarabit MCP to
@limeadelabs/clarabit-mcp@2.3.0The AI-helper features above (anchored comments, list discussion, save context) are MCP tools. They won't appear in your tool list until you upgrade — existing tools keep working on older versions, the new ones simply aren't registered there.
Requires
@limeadelabs/clarabit-mcp@2.3.0:cla_context_create— write new context entries (added in 2.1.0)cla_list_page_comments— list comments on a page (2.2.0)cla_update_pageverboseflag — opt back into the full body in the response (2.2.0)cla_prepare_page_comment_anchor— validated anchored-comment offsets (2.3.0)
Upgrade:
# Global install npm install -g @limeadelabs/clarabit-mcp@latest # Local install (in a project that pins the dep) npm install @limeadelabs/clarabit-mcp@latestThen restart your MCP client (Claude Code, Codex, etc.) so the new tool list is picked up at session start.
New MCP tools and API endpoints
cla_prepare_page_comment_anchor— validates and computes offsets for an anchored page comment without you manually counting characters. Pass one locator:exact_text(unique substring),prefix + text + suffix(disambiguate repeated text), orheading + text(scope to a markdown section). Returns offsets + the body revision the anchor was computed against, ready to drop intocla_create_page_comment. Repeats no longer get silently anchored to the first match — the tool returns a structuredambiguous_anchorerror with all candidate positions and their preview context.cla_list_page_comments— list comments on a page (optionally filtered by resolved state) without first walking projects to find it. Backed by a new flatGET /api/v1/pages/:id/commentsroute. Pages also now include acomments_countso you can see at a glance whether there's anything worth fetching.cla_context_create— complements the existing read tools so agents can write new context entries directly, not just edit ones the team already authored.GET /api/v1/tasks/:id— rounds out the CRUD on the HTTP side;cla_get_taskin MCP worked already, this is just for symmetry.Behavior changes
PATCH /api/v1/pages/:idreturns a minimal payload by default — id, title, version number, change summary. Passverbose: trueif you actually want the new body back. Cuts the round-trip in half on synthesis-style pages.cla_update_pageaccepts the same flag.- Page JSON now includes
version_number— the revision the current body lives at. Anchor helpers stamp this onto comments so drift is detectable later. Note the semantic: the latest snapshot's version_number stores the body that was current before the most recent edit; the current body is logically one revision past that. - Page comment author payload is nil-safe — external (share-link) authors are surfaced as
{ id: null, name, email, external: true }instead of the older{ id, name }shape that assumed a logged-in user. - Task-link API accepts both shapes —
{ url, title }and{ link: { url, title } }(the flat shape used to 500).