Skip to content

Guide

Troubleshooting

Fixes for Unknown readings, missing content scripts, permissions and shortcuts.

The ZIP will not load#

Chrome reports “Manifest file is missing or unreadable” when the folder you chose is not the extension itself. After extracting the ZIP you get one folder; select that folder, not the ZIP file and not a folder inside it. It is the folder containing manifest.json.

If the Load unpacked button is not there, Developer mode is still off — the switch is in the top-right corner of chrome://extensions.

A manually installed extension does not update itself. To move to a newer version, download the new ZIP, extract it, and either use the reload icon on the ForgeTally card or remove the old one and load the new folder. Your history, capsules and workspaces stay where they are.

Usage shows Unknown#

ForgeTally only shows what Claude displays. First check whether Claude is showing a usage indicator on the page at all. If it is not, Unknown is correct.

If Claude clearly shows usage and ForgeTally still says Unknown, the wording may have changed. You can see what the detector is reading:

  1. Click the ForgeTally logo in the popup five times to turn on developer mode.
  2. On claude.ai, press Ctrl+Shift+Y to open the debug overlay.
  3. For more detail, open DevTools, set the console context to ForgeTally, and run __forgeTally__.debug().

Please the FAQ with what the overlay shows. It contains no conversation text.

"ForgeTally is not attached to that tab"#

The Claude tab was opened before ForgeTally was installed or reloaded. Reload the Claude tab and try again.

Transfer finds no messages#

Transfer only reads messages that are visible on the page. Make sure the conversation is open, expand anything collapsed, and try again. If the conversation is very long, scroll through it first so the page has rendered the messages you want.

Chrome asks to approve permissions#

Some updates add a permission — downloads for exporting, clipboard access for transfers. Chrome disables the extension until you approve. The privacy policy explains what each permission is for.

Alt+Shift+C does nothing#

  • Another extension may use the same shortcut. Check chrome://extensions/shortcuts.
  • On older Chrome versions the popup cannot be opened by a shortcut, so ForgeTally shows a notification asking you to click its icon instead.

Something wrong or unclear on this page? Use the feedback button in the corner of the site — it saves a file on your device and sends nothing.