stubbi/asm

A home for assembly.
Asm is the package registry and command-line tool for assembly projects.
Create and test projects, inspect packages, and download exact artifacts.
Website · Quick start · Status · Why Asm · Security model · Sponsor Asm
Packages declare their targets and connect release records to exact source and artifact digests.
The project purpose explains our technical assumptions about AI-assisted assembly.
## Quick start
Asm 0.6.0 supports Linux x86-64, Linux ARM64, and Apple Silicon with macOS 15 or later.
### Install the command
Install GitHub CLI 2.93.0 or later before running the installer.
The installer uses it to check the CLI release's signed build provenance.
| System | Required tools |
| Linux | GitHub CLI at /usr/bin/gh, curl, and GNU Coreutils in /usr/bin. |
| Apple Silicon macOS | GitHub CLI at /opt/homebrew/bin/gh; other tools are supplied by macOS. |
sh
curl -qfsS -m120 https://asm.build/install.sh | sh
Apply the PATH command shown by the installer.
Then check the version:
sh
asm version
On Apple Silicon, the output is asm 0.6.0 (aarch64-macos).
Set PATH for this terminal
sh
export PATH="$HOME/.local/bin:$PATH"
Add this command to your shell configuration to keep the setting.
Installer source · Installation requirements · macOS filesystem and signing requirements
### Run your first project
Install GNU Binutils on Linux, or Xcode Command Line Tools on macOS with xcode-select --install.
On Debian or Ubuntu, the binutils package supplies the assembler and linker.
Run these commands from the directory that will contain your new project:
sh
asm new hello &&
cd hello &&
asm run
The program prints:
text
Hello from asm!
The project contains asm.toml, src/main.s, and tests/main.s.
Assembly source is text; asm build assembles and links it into the executable build/app.
asm run also runs that executable.
asm test builds and runs tests/main.s; a zero exit code passes the test.
If a build fails, use asm doctor to check the required tools.
### Update Asm
For an installation made with the installer:
sh
asm self update
For an installation managed by another package manager, use that manager to update Asm.
## Projects and packages
### Describe a project
asm.toml names the project and declares its target implementations:
toml
[package]
name = "hello"
version = "0.1.0"
[target.x86_64-linux]
source = "targets/x86_64-linux/src/main.s"
test = "targets/x86_64-linux/tests/main.s"
[target.aarch64-macos]
source = "targets/aarch64-macos/src/main.s"
test = "targets/aarch64-macos/tests/main.s"
Each target has its own source, test, and optional native-library fields.
The hello and math projects keep these inputs under targets/ /.
Asm selects the host target by default.
For cross builds, install the tools listed in the multi-target project contract.
From either reference project, asm build --target riscv64-linux builds a separate Linux artifact.
asm test --target riscv64-linux --no-run builds its test without executing it.
Target-specific dependency selections share one v2 lock.
asm new creates a single-target [build] manifest for your host.
This form remains supported.
### Find a package
sh
asm search hello
asm info stubbi/hello
asm versions stubbi/hello