Reference

Troubleshooting

“No transcripts found”

Actualis reads history that already exists. If you have never run Claude Code or Codex on this machine there is nothing to read. Check what it is looking at:

$ actualis --explain sources
$ ls ~/.claude/projects/*/ | head

If your history is elsewhere, point at it with --root DIR. If you set CLAUDE_CONFIG_DIR, that root is scanned too.

It is slow

Narrow the window. --days 7 skips any file untouched since the cutoff, which on a large fleet is the difference between reading thousands of files and reading a handful.

The macOS tray binary will not open

Released tray binaries are not yet signed with a Developer ID, so Gatekeeper refuses them — which is Gatekeeper working correctly. Build from source until that is fixed:

$ cd tray-go && go build -o actualis-tray .

A model shows as unpriced

A model with no published rate is billed at Opus-tier rates for display and excluded from confident totals, and the report says so. If a new model appears, open an issue — accuracy is the entire product, so a wrong number is a bug worth reporting.

The tray icon is invisible in my menu bar

Fixed in current builds. The icon now asks AppKit what the menu bar is drawing rather than what the system appearance is set to — a translucent bar over a light desktop picture renders light even in Dark Mode. If you still see it, please report it with a screenshot.

Something else

Open an issue on GitHub. Version and platform are enough; please do not paste scan output, transcripts or credentials.