SpecForge

Settings

Settings lives behind the gear in the sidebar footer, and on the terminal UI’s Settings screen. Both write the same configuration.

Desktop notifications

Notifications fire when a change first appears and when it is archived — never on ordinary file edits. Editing a proposal all afternoon produces nothing; finishing one produces exactly one notification.

On macOS the Dock badge mirrors the tray count, so the number is visible in the Dock and the ⌘-Tab switcher as well as the menu bar.

Gamification

A single toggle turns the gamified surfaces on or off. With it off, SpecForge is the browser, the tree and the graph, and nothing else.

Usage-quota gauges

SpecForge can show a small gauge for your AI coding-assistant usage — in the desktop sidebar footer, and in the terminal UI’s title bar. There are two, independent of one another:

  • Claude — your 5-hour and weekly utilization, with the 5-hour window split into 5 hour segments and the weekly into 7 day segments.
  • ChatGPT — the same gauge for your ChatGPT plan. Its segment count and length come from whatever window length the usage endpoint reports, falling back to 5 hours and 7 days only when the response omits it.

Both colour green → orange at 70% → red at 90%, and show a reset countdown when a window is spent. Each bar carries a live “now” marker at the elapsed point, so you read pace at a glance — budget spent, the fill, against time elapsed, the marker — rather than a per-hour history.

Both are off by default, and independent.

Enabling the Claude gauge reads your local Claude Code login to query Anthropic’s usage endpoint. Enabling the ChatGPT gauge reads your local Codex CLI login to query ChatGPT’s. Both are read read-only and never modified, and these are the application’s only network calls. With both toggles off, SpecForge makes none at all — nothing is read, and nothing is sent.

On a narrow terminal the title bar drops whole trailing gauge groups, ChatGPT before Claude, so enabling ChatGPT can never hide an otherwise-visible Claude gauge.

What settings write

Toggling a setting, or adding, removing, renaming or recolouring a workspace, writes SpecForge’s own configuration — the shared settings file, the workspace registry, and the presentation store. All three live outside any workspace.

Nothing here writes into a project. SpecForge does not edit specs, toggle task checkboxes, or touch git, whatever the settings say.