Catching up: the upgrade guide and sample workspace
Shipped in version 3.0.0
3.0 changes enough about how TaskForge looks and navigates that arriving cold, whether you're new or coming from 2.7, deserved more than a changelog. Two small additions handle that: a one-time guide for people upgrading, and, for new workspaces, real tasks instead of an empty list.
What moved in 3.0
If you're upgrading from a 2.7 release, the next time you open TaskForge you'll see a short sheet instead of the usual list of changes: What moved in 3.0. It replaces that list for this release only, because a couple of changes are big enough that a bullet point undersells them.
Three panels, each with a one-line explanation:
- The + button retired. The dock at the bottom replaced it. A Try it button opens the omnibar right there so you can see the replacement before you close the sheet.
- Lists are now spaces. Nothing about yours changed, same filters, same order, same tasks, but a space can now hold more than one section.
- Your workspace explains itself to AI. TaskForge writes files into your workspace that describe your task format to coding agents like Claude or Cursor. On Mac, a Set it up button jumps straight to turning on the local CLI and MCP server.
A link at the bottom opens Settings → About → Version History for everything else in the 3.0 changelog. This sheet itself is a launch-day briefing, not a reference: once you dismiss it, it's gone for good. The Tips library (Settings → About → Tips) holds a different kind of content, ongoing tips on using TaskForge, not a record of what changed in a given release, so it won't show this sheet again if you're looking for it later.
A workspace with real tasks in it, not an empty one
Start a new workspace and TaskForge seeds it with a small set of real tasks across three notes, not placeholder text. Check one off, edit one, delete one, they behave exactly like anything you'd write yourself, because they're regular files TaskForge just happened to create for you.
Welcome to TaskForge opens with four starter tasks: check one off, give one a due date, add one of your own from the dock, and a task marking that you've got TaskForge installed, already checked off so you see what "done" looks like. Below that, three tasks that exist to show you something rather than to get done: one deep-links to the raw markdown behind the file you're looking at (so you can see your own edit sitting in plain text), one opens the calendar, and one explains what the AI-agent files in your workspace are for.
Weekend trip is a believable small project: a task with a priority and a due date, a subtask under it, a task with a context, and one more with its own due date. Today's daily note carries a weekly recurring task (complete it and it comes back next week with an updated date) plus a task that references the Weekend trip project by name.
If you use task file formatting instead of inline tasks, the same content shows up as one file per task rather than grouped into three notes; the first file keeps a short "Sample, delete when you're ready" note explaining that it's plain text any AI tool can read.
Platform notes
Identical everywhere. The upgrade sheet only appears on the device where the 2.7 to 3.0 crossing actually happens, so if you use TaskForge on more than one platform you may see it more than once as each device updates.