Skip to content

Releases

Helm 0.4.1 (beta)

Helm 0.4.1 (beta) Pre-release
Pre-release

Choose a tag to compare

@CharlGottschalk CharlGottschalk released this 16 Nov 06:59
24dbe97

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
helm

Fixed 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)

Helm 0.4.0 (beta) Pre-release
Pre-release

Choose a tag to compare

@CharlGottschalk CharlGottschalk released this 12 Nov 14:17
73a14d6

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
helm

What'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)

Helm 0.3.0 (beta) Pre-release
Pre-release

Choose a tag to compare

@CharlGottschalk CharlGottschalk released this 12 Nov 10:59
4084310

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
helm

What'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-graph to 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-project to your host.
  • Fixes: helm --version prints the version instead of starting the server. On macOS, the workspace terminal no longer fails with posix_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)

Pre-release

Choose a tag to compare

@CharlGottschalk CharlGottschalk released this 12 Nov 10:59
4084310

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.0

What's new in 0.3.0

  • list settings 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 optional min, max and addLabel.
  • when conditions: a field is shown, and validated, only while a sibling field has one of the given values. isShown evaluates the condition.
  • suggestions on text fields: an options source offered as suggestions while still allowing free text.
  • settings.md and settings.schema.json are 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)

Helm 0.2.0 (beta) Pre-release
Pre-release

Choose a tag to compare

@CharlGottschalk CharlGottschalk released this 11 Nov 09:30
9b61117

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
helm

What'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 with tdt init and tdt doctor.
  • Add workspace in the workspace switcher opens the same flow.
  • helm workspace add <path> [--name <name>] [--init] and helm workspace list do 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)

Helm 0.1.0 (beta) Pre-release
Pre-release

Choose a tag to compare

@CharlGottschalk CharlGottschalk released this 10 Nov 13:31
e7cbe13

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
helm

What'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-sdk 0.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)

Pre-release

Choose a tag to compare

@CharlGottschalk CharlGottschalk released this 10 Nov 13:20
cdf4ae2

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, theme

What's in 0.2.0

  • Theme plugins: the helm.themes field in plugin.md and plugin.schema.json, theme rules in theme.md, validateTheme with WCAG contrast warnings, and helm-sdk create theme.
  • Contracts (version 1): widget, tool, settings, connection, theme tokens, UI kit, plugin and React.
  • Runtime: types and validators, the typed helm bridge (@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.