Changelog

  1. Extension 0.17.0

    • A comment written from the side panel updates the count on the toolbar icon in every tab showing that page, including one whose address differs only in its query order, a tracking parameter or a trailing slash.
    • A pin on a page that draws itself again after loading, such as the template preview, is found again on the new page rather than falling back to where it was placed.

    Server 0.17.0

    • A command run while the server is running refuses to migrate the database under it, and names the running server and both schema versions; a second commentware start is refused before it opens the database.
    • An admin can add, change and delete users, and create, list and revoke their access keys, over the HTTP API. No change can leave the server without an admin who can sign in.
    • Every HTTP route and MCP tool is checked against a list of the permissions it needs, so one with no entry is refused to every access key.

    Installer 0.20.0

    • When no Node.js is found, the one the installer offers to download is 24.22.2, which carries Node.js's latest security fixes.

    Template library (experimental) 0.4.0

    • A printed template with margins fits inside them, rather than being shrunk to fit the page.
    • A link to a place in the previewed page, such as a table of contents entry, jumps to it, and a link to another page opens in a new tab.
    • The preview draws a template once when it opens, so a Commentware comment pinned on it stays in place.
  2. Template library (experimental) 0.3.0

    • The preview's Pages switch lays a template out as printed pages, the size and margins it names, as text a Commentware comment can pin to. It is off until you turn it on, and the preview remembers the choice.
  3. Template library (experimental) 0.2.0

    • commentware-documents install-browser downloads the Chrome PDFs are printed with, from the library's own playwright-core, so it works with pnpm and yarn as well as npm and bun; npx playwright-core install chromium could download a build the library never looks for.
    • The library accepts any playwright-core 1.62 or later in the 1.x line, rather than exactly 1.62.0.
  4. Template library (experimental) 0.1.0

    • The first release of @commentware-private/documents, a library a developer adds to a Node project: templates for PDF and XLSX files written as code, a preview on 127.0.0.1:7043 that redraws as you edit, and the functions that render them from your own server. It is experimental, so its functions, options and commands may change or be removed in any release, with no notice first.
  5. Extension 0.16.0

    • A switch in the view menu previews every unresolved live edit on the page while the overlay is open, and the preview follows the page as it changes.
    • Right-clicking inside an iframe the page can read places the comment where you right-clicked, and a frame showing a PDF is treated as a viewer rather than as a page.
    • A comment placed on a page whose address carries a token or session parameter is found again on that page.
    3 more changes
    • Clicking a notification for a page that is already open brings that tab to the front and opens the thread, and a thread opens in a tab whose address differs only in its query order or a tracking parameter.
    • Comments can be placed on a plain-http page, and a pin or a capture that fails says so instead of leaving the page stuck.
    • Links to this site end in a slash, so they open without a redirect.

    Server 0.16.0

    • commentware mcp connect connects a local AI agent's MCP client to the server with a user and key of its own, commentware mcp clients lists the clients it finds, and commentware mcp disconnect takes one out again.
    • An AI agent that can run commands can send a file through a one-time upload link, and whoami names the server an agent is talking to.
    • The first start after updating backs the database up and moves comments saved under a page address with a token or session parameter onto the page they belong to.
    1 more change
    • Comment links and connection strings end in a slash, so they open without a redirect.

    Installer 0.19.0

    • A first install offers to connect the AI agents' MCP clients it finds on your machine, and --uninstall disconnects them.
    • The setup page and license links end in a slash, so they open without a redirect.
  6. Extension 0.15.0

    • The extension can place, move and put back pins on a server that stores every pin in the form a server release from 2027-01-17 may use.

    Server 0.15.0

    • A server announces, on the extension's Connection page and on the deprecations page, that a server release from 2027-01-17 may store pins that extensions before 0.15.0 cannot read, so update the extension before the server.
    • commentware --help labels each reference page with the page's own title, and the MCP tools page is now called MCP tools, prompts and resources.
  7. Extension 0.14.0

    • Comments can be placed in, and found again inside, iframes: an iframe from the same site as the page directly, and an iframe from another site through a small script the extension runs in every frame.
    • Right-clicking inside an iframe the extension can reach comments on what you right-clicked, and live edit works in an iframe loaded from the page's own address.
    • A comment placed too deep in the page for a server to store is refused when you place it, with a message that says why.
    3 more changes
    • Export and import move from the side panel to the options page's Export / Import screen, still experimental.
    • The update notice opens a page for updating, which names the version you have and the one available and gives the install command.
    • On Chrome 116 to 122, the right-click menu shows Commentware's items.

    Server 0.14.0

    • An AI agent can export threads to a file, import one through a one-time upload link, and place or move a pin inside an iframe or a component.
    • An imported thread keeps when it was resolved, and the resolved-thread purge counts from when it arrived.
    • commentware --help ends with links to the reference pages for commands, settings, the config file and the MCP tools, and commentware mcp links the tools reference.
    2 more changes
    • commentware settings list says when a setting governs an experimental feature.
    • A service installed through an installer for another hub kept that hub when you moved to a different installer; run commentware service uninstall and then commentware service install once to make it follow the installer.

    Installer 0.18.0

    • --uninstall names a directory of screenshots, drawings and attached files that your config file keeps outside the data directory, and leaves it in place.
  8. Extension 0.13.0

    • The extension asks the package registry at its own address whether a newer version is out; this site's /registry, which older extensions ask, becomes a redirect no earlier than 2027-01-12, and an older extension shows no update notice after that, so update before then.
    • The side panel exports a page's, a site's or a project's threads to a file and imports one into the project it shows, as an experimental feature of a server that offers it.
    • Comments can be placed in, and found again inside, web components that close their shadow roots, and a dialog inside one is recognized as a dialog.
    5 more changes
    • Opening a thread reads it from the server first, so the unread line, and the notifications reading it clears, match what the card shows.
    • When reading a page's threads again fails, the overlay and the side panel keep the pins and the open card they had.
    • Two Commentware extensions enabled in one browser no longer fight to stay on top of the page.
    • A reply that lands in a thread opened with nothing unread gets a line above it.
    • Muted text in the light theme has more contrast.

    Server 0.13.0

    • Deleting a comment deletes the files attached to it, and the first start after updating removes those of comments already deleted, after it backs the database up.
    • The cleanup of files no comment holds runs whatever resolved-purge-days is set to.
    • A document's creator is told of new threads on it, and an export leaves out the threads of a document review.

    Installer 0.17.0

    • The installer fetches every package from the package registry's own address, and the invite-code list from this site.
    • The installer deletes a kept invite code whose batch the hub no longer publishes, and asks for a new one.
    • A server the installer installs for a hub other than this one makes its connection strings on that hub.
  9. Extension 0.12.0

    • The extension's update notice names commentware-installer-cli.

    Server 0.12.0

    • commentware stop --all stops every server, and commentware service uninstall --all removes every unit service install wrote.
    • commentware users generate --json prints the new key for a program to read.

    Installer 0.16.0

    • The installer is commentware-installer-cli, and --install names what it installs: extension, server, or extension,server. --local-server refuses and names its replacement.
    • The install one-liners are /install/extension, /install/server and /install/extension-and-server, each as .sh and .ps1.
    • Installing the extension and a server together ends on the setup page with a Connect to this server button, so the connection string no longer has to be copied out of the terminal.
    2 more changes
    • The setup page says which Chrome profile it opened in, and why Commentware goes in that one.
    • The installer uninstalls what it installed with --uninstall, and asks before it deletes your data.
  10. Extension 0.11.0

    • The extension is published as @commentware-private/extension-dist, and versions under the old name are no longer served.
    • A project claims the addresses it lives at, and each tab opens in the project its address claims. The options page edits them.
    • The reply box has a bell. Turned off, your reply notifies only the people it mentions.
    5 more changes
    • Live edit rewrites a page's text in place and posts the rewrite as a comment. It has the microphone, and it comes back after a reload.
    • Escape closes only the topmost thing that is open, stops dictation first, and leaves a comment box alone unless you typed in it.
    • A dialog keeps the focus while it is open and gives it back when it closes.
    • Dictation setup opens in a window of its own, and a comment's dictation carries on through a reload.
    • Pressing a linked file in a document an agent opened asks that agent for the file.

    Server 0.11.0

    • The server is published as @commentware-private/cli-backend, and versions under the old name are no longer served.
    • If you installed with a package manager, uninstall @commentware/cli-backend, point the @commentware-private scope at this registry, and install @commentware-private/cli-backend.
    • If you installed with the installer, move ~/Commentware/server aside and run the installer again.
    3 more changes
    • The server runs in the background and stops cleanly, and commentware restart restarts it the way it was started.
    • The server carries everything it needs, so installing it fetches nothing else.
    • Pages that need the extension wait for it to start instead of saying it is not installed.

    Installer 0.14.0

    • The installer installs the server too, with --local-server. It brings its own Node.js when there is none, after asking, puts ~/Commentware/bin on your PATH, and starts the server on a first install.
    • The installer asks for your invite code and keeps it.
    • The installer installs the packages under their @commentware-private names.
  11. Extension 0.10.0

    • The extension draws a Markdown document an agent opened for comment, with the comment overlay on top. It is experimental.
    • The extension checks once a day whether a newer version is published, and tells you once when it is behind.
    • The microphone is ready as soon as an overlay opens, and is released five minutes after the last one closes. You can choose to start it only when you press the microphone.
    7 more changes
    • Keys you type in a comment no longer set off the page's own shortcuts.
    • Changing servers starts an open overlay or side panel over, so a comment never carries one server's mentions or attachments to another.
    • The first notification sound in a browser session is heard.
    • The extension's pages follow your browser's light or dark setting.
    • In the mention picker, Enter picks the name the arrow keys moved to.
    • The default server address is 127.0.0.1.
    • A feature that is going away is announced on the extension's Connection page.

    Server 0.10.0

    • An agent can open a Markdown document for comment, which the extension draws. It is experimental.
    • An agent can wait for a notification instead of asking for one again and again, and the discuss prompt keeps an agent answering until you stop it.
    • An access key is allowed 600 requests in every minute, so the extension no longer runs out after about an hour and a half.
    3 more changes
    • An MCP client that reaches your server as localhost can sign in.
    • A feature that is going away is announced when the server starts.
    • Uploading a file again restores it when the server had lost its copy.

    Installer 0.13.0

    • The installer is commentware-ext-installer-cli.
    • On a first install the installer opens the setup page in a Chrome profile of its own, named Commentware, and --profile or --default-browser opens it elsewhere.
    • The setup page opens on its Install or its Update tab, and an update whose page did not open says in the terminal to reload the extension.
    2 more changes
    • A word after the flags, such as install, is refused before anything is fetched instead of being ignored.
    • The installer prints the notices the extension it installs carries about features that are going away.
  12. Extension 0.9.2

    • A comment you have started survives a reload or the page going away, and posts on the page you wrote it on.
    • A thread you had open opens again after a reload, with your unfinished reply still in it.
    • The reply box empties when your reply is saved, not when somebody else's arrives.
    5 more changes
    • A server address written in another alphabet is shown in that alphabet, as Chrome shows it.
    • Dictation keeps running for as long as the box you started it from is open.
    • Text you select in your own comment bubble shows as selected.
    • A control you cannot use says what it is as well as why it is off.
    • The extension carries a notice of the third-party licenses inside it.

    Server 0.9.2

    • Setting up an AI agent shows one browser sign-in for each MCP client, and the Agents page has the steps for each.
    • MCP clients that do not say what kind of application they are can now register with your server.
    • Every request an agent makes over MCP is answered within thirty seconds.
    4 more changes
    • One dropped connection no longer stops your server.
    • A user's name is held to the same length as a nickname.
    • commentware settings set says it rewrote a value only when it did.
    • The server carries a notice of the third-party licenses inside it.

    Installer 0.11.0

    • The installer is commentware-ext, a single program fetched by a shell one-liner that needs no Node.js, and npx @commentware/extension is withdrawn.
    • The installer downloads exactly the release whose signature it checked, and refuses when the registry's answer cannot be checked.
    • The installer trusts only the hub and the signing key it was built with, whatever the environment it runs in says.
    1 more change
    • The installer runs on Linux systems from before 2021, such as Ubuntu 20.04, Debian 11 and RHEL 8.
  13. Extension 0.9.1

    • Documentation only: nothing changes in how the extension behaves.

    Server 0.9.1

    • Documentation only: nothing changes in how the server behaves.

    Installer 0.9.1

    • npx @commentware/extension installs the extension instead of printing its commands, and puts it in ~/Commentware/extension.
  14. Extension 0.9.0

    • The first release. Every package is signed.

    Server 0.9.0

    • The first release. Every package is signed.

    Installer 0.9.0

    • The first release. The installer checks each package's signature before it unpacks anything.