Skip to content

Install

Terminal window
curl -fsSL https://subtypelang.com/install.sh | sh

It downloads the latest sub for your system, checks its SHA-256 against the published SHA256SUMS, puts it in ~/.local/bin (no sudo) and tells you if that folder is not on your PATH. At the end it asks whether to install the Claude Code skill as well, so your agent writes scripts in Subtype.

Read the script first if you like: /install.sh is about 120 lines of plain sh.

Pass options after sh -s -- when you pipe:

Terminal window
curl -fsSL https://subtypelang.com/install.sh | sh -s -- --skill
Option Does
--skill also install the Claude Code skill, without asking
--no-skill do not install it, and do not ask
--skill-dir DIR where the skill goes (default ~/.claude/skills, or $CLAUDE_SKILLS_DIR)
--version X install a specific version instead of the latest
--dir DIR where sub goes (default ~/.local/bin, or $SUB_INSTALL_DIR)
--uninstall remove sub and the skill
--help show the options

The skill is copied to ~/.claude/skills/subtype. Nothing else in your Claude settings is changed. Start a new Claude Code session to pick it up. Details: For AI agents.

Latest version: 0.0.1 (built 2026-10-13 from commit b7297db6fbe8).

SystemDownloadSizeSHA-256
x86_64-unknown-linux-muslsub-0.0.1-x86_64-unknown-linux-musl.tar.gz6.2 MBe67e0c851fefb1ba…
Claude Code skillsubtype-skill-0.0.1.tar.gz0.0 MBfcfc2dd05bc430cf…

All checksums: SHA256SUMS. The latest version number is at /releases/latest/VERSION and latest.json.

Right now only Linux on x86_64 has a prebuilt binary (a static musl build that runs on any Linux distribution). macOS, Linux on ARM and Windows are not built yet: the installer says so and points you to the section below. This is an early preview and the language is still changing.

Terminal window
V=$(curl -fsSL https://subtypelang.com/releases/latest/VERSION)
curl -fsSLO https://subtypelang.com/releases/$V/sub-$V-x86_64-unknown-linux-musl.tar.gz
curl -fsSLO https://subtypelang.com/releases/$V/SHA256SUMS
grep x86_64-unknown-linux-musl SHA256SUMS | sha256sum -c -
tar -xzf sub-$V-x86_64-unknown-linux-musl.tar.gz
install -m 755 sub-$V-x86_64-unknown-linux-musl/sub ~/.local/bin/sub
sub --version

You need Rust. The first build compiles Wasmtime and takes a few minutes.

Terminal window
git clone <the Subtype repository> && cd subtype
cargo build --release # target/release/sub
cargo build --no-default-features # without Wasmtime: check, explain, manifest and build still work
Terminal window
sub --version
sub init demo && cd demo
sub explain main.sub
sub run main.sub
  • sub: command not found: ~/.local/bin is not on your PATH. Add export PATH="$HOME/.local/bin:$PATH" to your shell profile and open a new terminal.
  • checksum mismatch: nothing was installed. Try again; if it persists, tell us.
  • fetch fails with a certificate error: sub trusts your system’s certificate bundle ($SSL_CERT_FILE or the usual paths). Install ca-certificates.
  • Uninstall: curl -fsSL https://subtypelang.com/install.sh | sh -s -- --uninstall.