whatisgithub

What is smith.hx?

kn66/smith.hx — explained in plain English

Analysis updated 2026-05-18

13Tree-sitter QueryAudience · developerComplexity · 3/5Setup · moderate

In one sentence

A plugin manager for the Helix text editor that installs and removes plugins automatically based on a simple declarative list you write in your configuration file.

Mindmap

A visual breakdown will appear here once this repo is fully enriched.

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Declare a list of Helix plugins in init.scm and have them installed and loaded automatically at startup.

USE CASE 2

Remove a plugin from your configuration and have smith.hx uninstall it for you.

USE CASE 3

Create a lock file of exact plugin versions so you can restore the same setup on another machine.

USE CASE 4

Inspect, update, enable, or disable installed plugins using built in Helix commands.

What is it built with?

HelixSteelForgeScheme

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires a version of Helix built with Steel support plus the Forge executable already installed on your system.

The README does not state a license.

So what is it?

smith.hx is a plugin manager for the Helix text editor. It works on top of a package installer called Forge, which is part of the Steel scripting engine that Helix can be built with. Instead of manually copying files or running an installer script, you list the plugins you want inside a configuration file called init.scm, and smith.hx installs them for you and loads them when Helix starts. If you remove a plugin from that list later, smith.hx will uninstall it automatically, as long as it was originally installed by smith.hx itself. To use it, Helix needs to be built with Steel support, and Steel's forge command needs to be available on your system. Once that is in place, you install smith.hx itself with a single Forge command pointing at its GitHub repository. From there, you write plugin declarations directly in init.scm, including settings and keybindings for each plugin, and smith.hx takes care of installing them through Forge and wiring them into your Helix setup. Plugins can come from GitHub, GitLab, Codeberg, self hosted servers, or even local files. smith.hx figures out each plugin's name and its entry point automatically in most cases, though you can specify these by hand if a plugin does not follow the usual conventions. The tool also includes commands you can run inside Helix, such as smith-list to see what is installed, smith-update to refresh plugins, and smith-remove to take one out. You can create a lock file that records the exact installed version of every plugin, then use it later to restore those same exact versions elsewhere, which is useful if you want your Helix setup to look the same on a different machine. smith.hx keeps track of what it manages in its own registry file, so it never touches plugins that were installed outside of it.

Copy-paste prompts

Prompt 1
Help me set up Helix with Steel support so I can install smith.hx as my plugin manager.
Prompt 2
Walk me through declaring a plugin in init.scm using smith-plugin and syncing it with smith-init.
Prompt 3
Show me how to create a lock file with smith-lock and restore those exact plugin versions with smith-restore.
Prompt 4
Explain how smith.hx decides which plugins to remove when I edit my init.scm file.

Frequently asked questions

What is smith.hx?

A plugin manager for the Helix text editor that installs and removes plugins automatically based on a simple declarative list you write in your configuration file.

What language is smith.hx written in?

Mainly Tree-sitter Query. The stack also includes Helix, Steel, Forge.

What license does smith.hx use?

The README does not state a license.

How hard is smith.hx to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is smith.hx for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.