Troubleshooting

Make sure you have at least one Claude Code or Codex session. CostDog reads existing log files — if you haven't used either tool yet, there's nothing to scan. Try running a quick Claude Code session, then click the refresh button in the widget.

CostDog is not signed with an Apple Developer certificate. Run this command to remove the quarantine attribute: xattr -cr /Applications/CostDog.app Then open the app normally.

CostDog uses always-on-top window flags. If it's not staying on top, try clicking the widget to focus it. On some macOS versions, you may need to grant accessibility permissions.

CostDog currently uses estimated per-model rates. A future update will add real-time pricing via the OpenRouter API for 339+ models. Check the model breakdown to see which models are being tracked.

Download the latest installer from GitHub Releases and install over the existing version. Your database and settings are preserved in ~/.costdog/.

Yes. Click and drag the top bar of the widget to reposition it. On macOS, make sure you're dragging the bar area (where the dog emoji and cost are shown).

The web panel runs on http://localhost:3456. Make sure no other application is using that port. You can change the port with the COSTDOG_PORT environment variable.

Delete the database file at ~/.costdog/costdog.sqlite and restart CostDog. It will rebuild from your existing Claude Code and Codex session logs.