Repository navigation
Releases
Helm 0.4.1 (beta)
Beta. Helm and its SDK are in beta (0.x). Expect bugs, and changes between versions. Report problems in issues.
@usetdt/helm@0.4.1 on npm, published from this tag by GitHub Actions with a provenance statement. It requires @usetdt/helm-sdk@^0.3.0 (unchanged).
npm install -g @usetdt/helm # Node 24+
npm install -g @usetdt/helm --allow-scripts=node-pty # Linux: needed for the workspace terminal
helmFixed in 0.4.1
- Token usage report: projects. A session is now named after the git repository it worked in, not the folder the agent started in. Sessions started in a workspace folder that edit repositories elsewhere now show those repositories (the one touched most) instead of the workspace folder's name. Only the repository's name leaves the server, never a path.
Full changes: helm-v0.4.0...helm-v0.4.1. Guides: helm.usetdt.com. License: FSL-1.1-ALv2 (Apache-2.0 two years after each release).
Helm 0.4.0 (beta)
Beta. Helm and its SDK are in beta (0.x). Expect bugs, and changes between versions. Report problems in issues.
@usetdt/helm@0.4.0 on npm, published from this tag by GitHub Actions with a provenance statement. It requires @usetdt/helm-sdk@^0.3.0 (unchanged).
npm install -g @usetdt/helm # Node 24+
npm install -g @usetdt/helm --allow-scripts=node-pty # Linux: needed for the workspace terminal
helmWhat's new in 0.4.0
- Usage limits. The Sessions panel shows how much of your Claude Code and Codex 5-hour window you have used; point to it or click it for the weekly window and reset times. Helm reads the hosts' own usage sources, never refreshes your Claude login, and you can turn it off in Settings → Appearance.
- Token usage report. A new Token usage view counts the tokens Claude Code and Codex used on this machine, from their own transcript files. Pick a day (or Yesterday), a week or a month, step back to earlier periods, and see the heaviest sessions, projects or models. The main number is new tokens (input, cache writes and output); cache reads are shown apart. Only numbers leave the server, never message text or paths.
- Context window. The header of a session Helm started shows how full the agent's context window is.
- Your name. Set the name Helm uses for you in Settings → Appearance; it replaces "Operator" and stays in your browser.
Full changes: helm-v0.3.0...helm-v0.4.0. Guides: helm.usetdt.com. License: FSL-1.1-ALv2 (Apache-2.0 two years after each release).
Helm 0.3.0 (beta)
Beta. Helm and its SDK are in beta (0.x). Expect bugs, and changes between versions. Report problems in issues.
@usetdt/helm@0.3.0 on npm, published from this tag by GitHub Actions with a provenance statement. It requires @usetdt/helm-sdk@^0.3.0.
npm install -g @usetdt/helm # Node 24+
npm install -g @usetdt/helm --allow-scripts=node-pty # Linux: needed for the workspace terminal
helmWhat's new in 0.3.0
- Project graph. A linked project's page shows its file graph: files coloured by kind (code, instructions, docs) and lines by relation (imports, calls, references). You can search files and symbols. The graph comes from TDT (
tdt_project_graph, TDT 0.1.15 or later), which builds it with graphify. Generate graph hands/tdt-project-graphto your host; Helm itself never runs graphify. Helm's graphify integration is community-built and is not affiliated with or endorsed by Graphify Labs. - Bookmarks widget. A built-in widget for a list of links. Each link opens in a new tab, and only http(s) URLs are accepted.
- Configurable Quick actions. Choose each instance's buttons. A button can run a skill in a new session, open a tool, run a Helm function or start a local app. Local apps come from an allowlist in Settings → Local apps, and the server runs them without a shell. Existing dashboards keep their six buttons.
- Add a project by its folder. The Projects + opens a folder browser and hands
/tdt-add-projectto your host. - Fixes:
helm --versionprints the version instead of starting the server. On macOS, the workspace terminal no longer fails withposix_spawnp. Long settings forms no longer push the dialog off screen.
Full changes: helm-v0.2.0...helm-v0.3.0. Guides: helm.usetdt.com. License: FSL-1.1-ALv2 (Apache-2.0 two years after each release).
@usetdt/helm-sdk 0.3.0 (beta)
Beta. Helm and its SDK are in beta (0.x). Expect bugs, and changes between versions. Report problems in issues.
@usetdt/helm-sdk@0.3.0 on npm, published from this tag by GitHub Actions with a provenance statement.
npm install -D @usetdt/helm-sdk@^0.3.0What's new in 0.3.0
listsettings field: a repeatable group of sub-fields that users add, edit, reorder and remove in the settings form. It holds up to 50 entries (LIST_MAX), with optionalmin,maxandaddLabel.whenconditions: a field is shown, and validated, only while a sibling field has one of the given values.isShownevaluates the condition.suggestionsontextfields: an options source offered as suggestions while still allowing free text.settings.mdandsettings.schema.jsonare updated. A plugin that uses these needs SDK 0.3.0 or later.
Full changes: helm-sdk-v0.2.0...helm-sdk-v0.3.0. Docs: helm.usetdt.com/docs/sdk. License: Apache-2.0.
Helm 0.2.0 (beta)
Beta. Helm and its SDK are in beta (0.x). Expect bugs, and changes between versions. Report problems in issues.
@usetdt/helm@0.2.0 on npm, published from this tag by GitHub Actions with a provenance statement.
npm install -g @usetdt/helm # Node 24+
npm install -g @usetdt/helm --allow-scripts=node-pty # Linux: needed for the workspace terminal
helmWhat's new in 0.2.0
- First-run onboarding. With no workspace configured, Helm opens a setup screen instead of an empty shell. It checks TDT, offers to install it with pipx (
pipx install 'thisdamnthing[mcp]', shown and confirmed first) or a per-OS guide, then lets you browse to a folder and connect an existing workspace or create one withtdt initandtdt doctor. - Add workspace in the workspace switcher opens the same flow.
helm workspace add <path> [--name <name>] [--init]andhelm workspace listdo the same from a terminal.- Clearer TDT errors. When TDT starts but exits (wrong path, an older
tdt, a missing MCP extra), Helm now shows TDT's own message instead of "MCP error -32000: Connection closed". - Left rail: the Design system link is gone; the page is still in Quick actions.
- Releases: npm packages are now published from tags by GitHub Actions with npm trusted publishing and provenance.
- Guides updated: getting started, configuration, troubleshooting, dashboard and security.
Full changes: helm-v0.1.0...helm-v0.2.0. Guides: helm.usetdt.com. License: FSL-1.1-ALv2 (Apache-2.0 two years after each release).
Helm 0.1.0 (beta)
Beta. Helm and its SDK are in beta (0.x). Expect bugs, and changes between versions. Report problems in issues.
First public release of Helm, a local Command Deck for ThisDamnThing workspaces: @usetdt/helm.
npm install -g @usetdt/helm # Node 24+
npm install -g @usetdt/helm --allow-scripts=node-pty # Linux: needed for the workspace terminal
helmWhat's in 0.1.0
- Shell: dashboard grid with a widget library, tabbed tools, five built-in themes and theme plugins, settings and keyboard shortcuts.
- Live TDT data through
tdt mcp serve: workspaces, projects, 13 built-in widgets, the brain graph and the record reader. - Agents: chat hand-off and builds to Claude Code or Codex in terminal sessions; Helm never runs a model itself.
- Workspace terminal (node-pty), limited to the workspace folder.
- Plugins: widgets, tools and themes from npm or a folder (
helm plugin add | link), sandboxed with declared connections (TDT MCP, other MCP servers, HTTP, files, databases) and confirmed writes. Built on@usetdt/helm-sdk0.2.0. - Database connections (SQLite, Postgres, MySQL) and a DB explorer.
- Security: loopback only, a per-start bearer token, Host/Origin checks and CSP; credentials in the OS keychain.
Guides: helm.usetdt.com. License: FSL-1.1-ALv2 (Apache-2.0 two years after each release).
@usetdt/helm-sdk 0.2.0 (beta)
Beta. Helm and its SDK are in beta (0.x). Expect bugs, and changes between versions. Report problems in issues.
First public release of the Helm plugin SDK on npm: @usetdt/helm-sdk.
npx @usetdt/helm-sdk create widget my-widget # or: tool, themeWhat's in 0.2.0
- Theme plugins: the
helm.themesfield inplugin.mdandplugin.schema.json, theme rules intheme.md,validateThemewith WCAG contrast warnings, andhelm-sdk create theme. - Contracts (version 1): widget, tool, settings, connection, theme tokens, UI kit, plugin and React.
- Runtime: types and validators, the typed
helmbridge (@usetdt/helm-sdk/frame) and React hooks and components (@usetdt/helm-sdk/react). - CLI:
helm-sdk create | build | validate | dev.
Docs: helm.usetdt.com/docs/sdk. License: Apache-2.0.