Skip to content

Releases: sidkr222003/FocusForge

[2025-05-07] - v1.0.0 & v1.1.0

07 May 17:34
6f6125b

Choose a tag to compare

Release Notes — v1.1.0 🚀

This is the first public release. Here's what ships:

Core Tracking

  • Active time / idle time separation with configurable idle threshold (default: 2 min)
  • Engaged activity detection (default: 30-second threshold)
  • Session start, end, pause, and resume
  • Flow state detection after 25 continuous active minutes
  • Focus Score computed from active ratio, flow minutes, idle count, and break hygiene

Pomodoro Engine

  • 25 / 5 / 15 minute work/short-break/long-break defaults, fully configurable
  • Auto-advance between phases
  • Bell sound on phase transitions
  • Status bar badge showing current Pomodoro phase

Dashboard (Webview)

  • Today tab: live stats, Focus Score gauge, 12-week heatmap, language donut
  • Goals tab: daily goal ring with milestone markers, ETA, session planner, .ics calendar export
  • Awards tab: 100+ achievements across 12 categories, Bronze → Diamond progression
  • History tab: 14-session bar chart, session detail panel, language leaderboard, JSON/CSV export
  • Journal tab: mood-tagged entries, weekly view, mood filter

Project & Git Integration

  • Auto-detection from active workspace, Git roots, nested repos, and git remote -v
  • Commit correlation for commits made during a tracked session
  • Language breakdown from VS Code document.languageId

GitHub Issue Log

  • Local repo detection from workspace and Git extension API
  • Token-based fallback for repos not cloned locally
  • Issue list, labels, assignees, comments
  • Create issue, comment, open in browser, copy link, close/reopen
  • Completion logs included in weekly reports

Reports

  • Markdown and HTML weekly reports saved to .vscode/session-reports/
  • Auto-generate on session end (configurable)

Deep Work Mode

  • Configurable duration (default: 50 min)
  • Optional activity bar hide, notification mute
  • Status bar indicator

Ambient Audio (powered by musicforprogramming.net)

  • Streams the full musicforprogramming.net catalogue (70+ curated coding soundscape episodes) — credit to isdampe/music-for-programming for the inspiration
  • Toggleable rain overlay sourced from rainymood.com
  • Independent volume control
  • Auto-start with session (configurable, off by default)
  • Auto-pause on idle, auto-resume on activity — audio mirrors your actual focus state
  • Accessible from VS Code sidebar, no browser tab needed

Optional Features

  • GitHub Gist team leaderboard (opt-in)
  • GitHub Models AI weekly insight using openai/gpt-4.1-mini (opt-in)

Privacy

  • All session data in VS Code global state
  • GitHub token in VS Code SecretStorage
  • No extension-owned server, no telemetry pipeline

Install It

Search FocusForge in the VS Code Extensions tab, or:

ext install NK2552003.focusforge

Or grab it directly from the VS Code Marketplace →


If you have ideas or hit bugs, drop them in the comments or open an issue.

What's Changed

  • Update from task ee64f650-57e2-4243-8a81-ee72ffb91162 by @sidkr222003 in #1
  • Update from task 0faba4a2-2792-4df0-9fe1-d0d80500a1eb by @sidkr222003 in #2
  • Update from task a914baa3-f756-42d7-81ac-6be8f6fab72a by @sidkr222003 in #3

New Contributors

Full Changelog: https://github.com/sidkr222003/FocusForge/commits/v1.0.0