feat: Post-launch polish: launch-at-login toggle + OAuth token caching#57
Merged
Conversation
Claude Code rotates its keychain item periodically, which wipes the trusted-app ACL granted via "Always Allow" — so the next QuotaProbe poll re-fires the password-entry prompt. Most rotations happen before the old token actually expires, so caching the token in memory and only re-reading the keychain on a 401 cuts the prompt frequency to the rate of true token expiry rather than the rate of rotation. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Bootstrap already installs a panel LaunchAgent with RunAtLoad=true, so fresh installs already auto-launch at login. The new toggle surfaces that behavior so users can opt out without hand-editing launchd plists. Off: unload + delete ~/Library/LaunchAgents/com.stackonehq.stack-nudge.plist. On: rewrite the plist (if missing) and launchctl load. The daemon plist (voice) is intentionally untouched — toggling panel auto-launch shouldn't affect voice playback registration. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
…notes action - "Quota tracking" master toggle (default On) gates the /api/oauth/usage poller entirely. Off = no keychain access at all, hard kill switch for users who don't care about quota. - "Poll frequency" cycle surfaces STACKNUDGE_USAGE_POLL_MIN from config to Settings; options 1/2/5/10/15/30 min. Visible-panel cadence stays fixed at 60s. - "View release notes…" action opens github.com/StackOneHQ/stack-nudge/releases/tag/v<version>, falling back to /releases if version unknown. Row layout: +3 rows (master toggle + poll cycle in Usage, release-notes action in Actions). All downstream switch cases shifted. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Previously the Usage tab showed whatever snapshot was last fetched, even after the user disabled polling — looked like fresh data but was actually frozen. Now: clear the cached snapshot on toggle-off, and render a dedicated "Quota tracking is off" empty state with a pointer back to Settings. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
- Footer status now distinguishes "Tracking off", "Syncing…", "Never synced", and "Updated 5s ago" instead of just the relative time. - 'r' in the Usage tab triggers an immediate quota probe (skipped when tracking is off). Footer hint "Sync now [r]" advertises it. - nav.quotaSyncing exposed so the UI can flash "Syncing…" while a fetch is in-flight; cleared in the completion handler whether the fetch succeeded or failed. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
'p' on the Usage tab toggles STACKNUDGE_QUOTA_TRACKING — mirrors the Settings row but reachable without leaving the tab. On resume, fires an immediate probe so the user sees fresh data right away instead of waiting for the next scheduled tick. Footer hint flips between "Pause [p]" and "Resume [p]" depending on current state. Toggle logic extracted to PanelNav.toggleQuotaTracking so the row and the keystroke share one path. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
hiskudin
changed the title
hiskudin
changed the title
hiskudin
changed the title
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
A bundle of small UX + behavior polish landing after the v1.9.1 launch.
Settings
/api/oauth/usagepoller entirely — hard kill switch for users who don't want keychain access for usage tracking.STACKNUDGE_USAGE_POLL_MINfrom config to the UI. Visible-panel cadence stays fixed at 60s.github.com/StackOneHQ/stack-nudge/releases/tag/v<version>for the running bundle, falls back to/releasesif version unknown.Usage tab
rkeystroke: sync now (immediate probe), with footer hint.pkeystroke: pause / resume tracking without leaving the tab. On resume, fires an immediate probe so fresh data appears right away.Tracking off/Syncing…/Never synced/Updated Ns agoinstead of just the relative time.Keychain prompt fix
QuotaProbenow caches the OAuth token in memory and only re-reads the keychain on a 401. Claude Code rotates its keychain item periodically (which wipes the trusted-app ACL granted via "Always Allow"); caching means we only hit the keychain — and therefore only risk a prompt — when the current token actually stops working. Cuts prompt frequency to true-expiry cadence instead of rotation cadence.Test plan
~/Library/LaunchAgents/. On → plist returns andlaunchctl list | grep stackonehqshows it loaded. Log out + back in to verify auto-launch behavior matches the toggle.randSync nowhint hidden. On → probe fires within the configured interval; footer shows fresh "Updated Ns ago".r→ footer briefly shows "Syncing…" then "Updated 0s ago". Pressp→ snapshot clears, footer says "Tracking off", hint flips to "Resume". Presspagain → immediate probe fires.🤖 Generated with Claude Code