Changelog
Back to All

Bi-Directional Sync for Bitbucket

November 5, 2026

Bitbucket Cloud now joins GitHub and GitLab with full bi-directional sync support in ReadMe, available to everyone. Whether you edit your docs in ReadMe or push changes from your Bitbucket repo, both sides stay in sync.

New Features & Improvements

Git Sync

  • Bi-directional sync with Bitbucket Cloud is out of beta and available to every project, including enterprise groups and their child projects. To set it up, install the ReadMe Sync app on your Bitbucket workspace, create an empty repository, and paste in the verification code.

AI

  • Agents can now create and update changelog posts. New posts are always created hidden. The agent can only edit public posts if you turn on Edit Public Changelog Posts in the AI Writer settings.
  • Ask AI has an “Internal Only” setting for admins to try and demo before enabling for end users.
  • With the AI disclaimer turned on, you can now replace the default text with your own in the Ask AI settings or in the Enterprise dashboard's Customize Ask AI modal.

MCP

  • ReadMe's MCP server now supports OAuth: sign in with your ReadMe account instead of creating an API key for each project, and your agent can work across every project you have access to (or sign up and create your first one). API keys still work for Cursor, CI/CD pipelines, and agents that don't support MCP OAuth.
  • You can now write instructions for your MCP server, which AI clients pass to the model when they connect. Enterprise groups can set instructions for every child project, and each child can override them.
  • If you run your own MCP server, you can now publish a custom MCP server card from the AI Discovery settings. ReadMe serves your card in place of its own, even when the ReadMe MCP server is off. Enterprise groups can set one card for all child projects.

Docs

  • The Theme Editor now has a Toggle Style setting for the light/dark switch: Dropdown (the default), Segmented, Slider, or Switch.
  • Selected text and <mark> highlights now use your Accent color.

Editor

  • If you leave the page editor with unsaved changes, the prompt now has a Save & Leave option.

Enterprise

  • New Dismiss Stale Approvals branch rule on the Enterprise dashboard's Projects page. With it on, an approved branch goes back to review whenever new changes are made. Teammate approval must be required to turn it on.
  • Enterprise landing pages now use the new search experience with Ask AI built in, and you can set Search Modal and Ask AI Placement in their appearance settings.

Translations

  • [Beta] In the editor, you can now mark text as Do Not Translate so AI translation leaves it as written.
  • [Beta] Custom Ask AI disclaimer text is translated automatically into each AI translation language.

Bugs Eaten (by Owlbert) 🐛

Editor

  • Delete in an image's settings menu now removes the whole image, and image settings show reliably on images wrapped left or right.
  • Tab key behavior now moves from a Card or Accordion icon into its title and then its description.
  • Link editing and Edit with AI work inside the Reusable Content modal.
  • Table headers with no alignment set are now left-aligned in the editor, matching the published page.
  • Endpoint descriptions edited in the API Designer keep their line breaks.
  • Pages duplicated into a different category stay in that category.
  • Category names that contain %20 remaing when you reorder the sidebar.

AI

  • Edit with AI now returns only the edited text, with no extra tags around it.
  • The AI Agent now asks before Apply or Revert throws away unsaved edits in the editor.

Docs

  • Admins and editors can now see hidden Changelog and Discussions sections in the top navigation.
  • Custom favicons on older projects show again in place of the default ReadMe icon.

Enterprise

  • Docs Audit on enterprise group child projects no longer flags valid links that start with a child project's path.
  • Searching pending invites in the Enterprise dashboard now matches emails regardless of capitalization.
  • Enterprise Ask AI analytics now show each project's name, with its subdomain underneath.

Git Sync

  • Review diffs now list pages that were renamed with no content changes. A parent page converted to a regular page now shows as a single change.
  • Merge commits from ReadMe now show the person who merged as the author in your repository, or ReadMe when there's no merging user.

CLI

  • rdme now uploads parent pages before their child pages.
  • readme lint no longer flags an empty index.md when its child pages live in nested directories.
  • The CLI now installs on npm 12.