stubbi/asm

选用指南

AI 根据 README 整理 · 2026/11/6 05:42:00

使用方式

通过命令行使用，支持创建项目、构建、运行、测试、搜索包、安装程序等操作。

查看 README 依据

[Installer source](https://asm.build/install.sh) · [Installation requirements](docs/self-update.md) · [macOS filesystem and signing requirements](docs/macos.md) ### 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 doctor && asm new hello && cd hello && asm run && asm test ``` 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. ### 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, its source file, and its target: ```toml [package] name = "hello"

`asm test --target riscv64-linux --no-run` builds its test without executing it. Target-specific dependency selections share one v2 lock. See the [multi-target project contract](docs/multi-target-projects.md) for tools, commands, and platform limits. ### Find a package ```sh asm search hello asm info stubbi/hello asm versions stubbi/hello asm fetch stubbi/hello@0.6.0 --target x86_64-linux --kind source ``` This downloads the Linux x86-64 source archive and checks its size and SHA-256 digest. Use `asm --help` for command options. ### Use a source dependency

部署要求

需要 GitHub CLI 2.93.0 或更高版本，以及系统工具如 curl、GNU Coreutils；Linux 还需 GNU Binutils，macOS 需 Xcode Command Line Tools。

查看 README 依据

Asm brings assembly into a shared package ecosystem: named packages, explicit machine targets, repeatable builds, and evidence tied to each release. The goal is to make efficient, dependable software practical to distribute and reuse. [More on the technical reasoning](docs/why-asm.md). ## 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](https://cli.github.com/) before running the installer. | 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)`. <details> <summary>Set PATH for this terminal</summary> ```sh export PATH="$HOME/.local/bin:$PATH" ``` Add this command to your shell configuration to keep the setting. </details>

[Installer source](https://asm.build/install.sh) · [Installation requirements](docs/self-update.md) · [macOS filesystem and signing requirements](docs/macos.md) ### 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 doctor && asm new hello && cd hello && asm run && asm test ``` The program prints: ```text Hello from asm! ```

已知限制

Asm 目前是早期 alpha 版本，跨目标原生库链接尚不支持，托管注册表和 MCP 部署仍在验证中。

查看 README 依据

Use `owner/name@version` to select an exact version. `update` and `remove` continue to manage project source dependencies. Published 0.4.0 binaries do not include these management commands. Updating Asm does not adopt earlier installations; programs without an inventory record remain unmanaged. See the [installed-program contract](docs/installed-programs.md) for file checks, recovery, and limits. ## Status Asm is an early alpha. | Area | Available today | | --- | --- | | Native CLI | Linux x86-64, Linux ARM64, and Apple Silicon macOS 15+. |

| Artifact checks | Metadata, size, SHA-256, archive structure, and executable format. | | CLI updates | Manual updates with signed release provenance. | Asm 0.6.0 adds named target implementations, standalone Linux cross builds, and target-specific dependency locks. The [release notes](docs/releases/0.6.0.md) describe the commands, artifact scope, and limits. Projects select the native host by default. Explicit standalone Linux builds produce separate artifacts without executing them. Cross-target native-library linking remains unsupported.

Follow the [publishing guide](registry/README.md) for the commands and submission process. ## Build with an AI The [Asm development skill](skills/asm-build/SKILL.md) guides requirements, target selection, package reuse, tests, and bounded performance work. The [MCP setup guide](docs/agents.md) connects AI clients to read-only discovery, planning, and measurement-comparison tools. The AI uses its authorized workspace tools to build and execute software. Hosted registry and MCP deployment remain under qualification.