Cobrust v0.7.0-rc1

Installation

v0.6.0 adopts the FHS-ish bin/lib/share wheel layout per
ADR-0069. Tarballs extract to a single self-contained
cobrust-v0.7.0-rc1/ directory.

Option A — cargo install (requires Rust toolchain)

cargo install --git https://github.com/Cobrust-lang/cobrust cobrust-cli

Option B — prebuilt wheel (no Rust needed; v0.6.0 layout)

Pick the tarball for your platform + CPU level, extract to a
stable location, and symlink the cobrust binary into your
$PATH. The runtime + stdlib live in lib/ + share/
siblings; do NOT move the binary out of its bin/ directory.

# macOS Apple Silicon M1 (tier-1)
curl -L https://github.com/Cobrust-lang/cobrust/releases/download/v0.7.0-rc1/cobrust-v0.7.0-rc1-aarch64-apple-darwin-m1.tar.gz | tar xz -C $HOME/.local/
ln -sf $HOME/.local/cobrust-v0.7.0-rc1/bin/cobrust $HOME/.local/bin/cobrust

# Linux x86_64 — glibc baseline (tier-1). REQUIRES system LLVM 18
# at runtime (the binary dynamically links libLLVM — ADR-0070 X.3
# made LLVM the default backend). Install it first:
#   sudo apt-get install -y libllvm18    # (or: llvm-18)
curl -L https://github.com/Cobrust-lang/cobrust/releases/download/v0.7.0-rc1/cobrust-v0.7.0-rc1-x86_64-unknown-linux-gnu-v1.tar.gz | tar xz -C $HOME/.local/
ln -sf $HOME/.local/cobrust-v0.7.0-rc1/bin/cobrust $HOME/.local/bin/cobrust

# NOTE: the static-musl + aarch64-linux wheels are DEFERRED at
# v0.7.0 (ADR-0070 X.6 / finding F77 — LLVM-default blocks
# static-musl-link + `cross`). On those targets use Option A
# (cargo install) until v0.7.x restores them.

Each wheel tarball bundles:

• bin/cobrust — the single driver binary; the LSP / DAP servers are the cobrust lsp / cobrust dap subcommands (ADR-0068). The transitional cobrust-lsp / cobrust-dap shim binaries were removed at v0.7.0 (ADR-0070 X.5) — IDE extensions must invoke the subcommands.
• lib/cobrust/libcobrust_stdlib.a — prebuilt static stdlib archive
• share/cobrust/runtime/{cobrust_main.c,cpu_features.c} — runtime C entrypoint + CPU feature helpers

Option C — Alpine / distroless container (musl static binary)

DEFERRED at v0.7.0: the static-musl wheel is not built (ADR-0070
X.6 / finding F77 — LLVM-default blocks a fully-static musl link).
On Alpine, build from source (Option A, with llvm18-dev from the
community repo) or use a glibc-based image with the
x86_64-unknown-linux-gnu wheel + libllvm18. The musl wheel
returns in v0.7.x.

Quick start

cobrust new hello && cd hello && cobrust run src/main.cb
# → hello, world

See Getting Started for the full guide.

Breaking change from v0.5.x

Users who manually cp cobrust /usr/local/bin/ from a flat
v0.5.x tarball MUST re-install via the new tar xz →
ln -s flow above. Per F46: the v0.5.x flat-binary wheel
was unusable for cobrust run regardless because the
runtime + stdlib were not bundled (binary baked the GH
Actions runner workspace path). v0.6.0 fixes both sides.

Cobrust v0.6.2

Installation

v0.6.0 adopts the FHS-ish bin/lib/share wheel layout per
ADR-0069. Tarballs extract to a single self-contained
cobrust-v0.6.2/ directory.

Option A — cargo install (requires Rust toolchain)

cargo install --git https://github.com/Cobrust-lang/cobrust cobrust-cli

Option B — prebuilt wheel (no Rust needed; v0.6.0 layout)

Pick the tarball for your platform + CPU level, extract to a
stable location, and symlink the cobrust binary into your
$PATH. The runtime + stdlib live in lib/ + share/
siblings; do NOT move the binary out of its bin/ directory.

# macOS Apple Silicon M1 (tier-1)
curl -L https://github.com/Cobrust-lang/cobrust/releases/download/v0.6.2/cobrust-v0.6.2-aarch64-apple-darwin-m1.tar.gz | tar xz -C $HOME/.local/
ln -sf $HOME/.local/cobrust-v0.6.2/bin/cobrust $HOME/.local/bin/cobrust

# Linux x86_64 — glibc baseline (tier-1)
curl -L https://github.com/Cobrust-lang/cobrust/releases/download/v0.6.2/cobrust-v0.6.2-x86_64-unknown-linux-gnu-v1.tar.gz | tar xz -C $HOME/.local/
ln -sf $HOME/.local/cobrust-v0.6.2/bin/cobrust $HOME/.local/bin/cobrust

# Linux x86_64 — static musl (Alpine / distroless / minimal containers)
curl -L https://github.com/Cobrust-lang/cobrust/releases/download/v0.6.2/cobrust-v0.6.2-x86_64-unknown-linux-musl-v1.tar.gz | tar xz -C $HOME/.local/
ln -sf $HOME/.local/cobrust-v0.6.2/bin/cobrust $HOME/.local/bin/cobrust

Each wheel tarball bundles:

• bin/cobrust — main driver (also exposes cobrust lsp + cobrust dap subcommands per ADR-0068)
• bin/cobrust-lsp + bin/cobrust-dap — transitional shim binaries (deleted at v0.7.0; extension v0.1.x compat)
• lib/cobrust/libcobrust_stdlib.a — prebuilt static stdlib archive
• share/cobrust/runtime/{cobrust_main.c,cpu_features.c} — runtime C entrypoint + CPU feature helpers

Option C — Alpine / distroless container (musl static binary)

FROM alpine:latest
RUN apk add --no-cache curl tar
RUN curl -L https://github.com/Cobrust-lang/cobrust/releases/download/v0.6.2/cobrust-v0.6.2-x86_64-unknown-linux-musl-v1.tar.gz | tar xz -C /opt/ \
    && ln -s /opt/cobrust-v0.6.2/bin/cobrust /usr/local/bin/cobrust

Quick start

cobrust new hello && cd hello && cobrust run src/main.cb
# → hello, world

See Getting Started for the full guide.

Breaking change from v0.5.x

Users who manually cp cobrust /usr/local/bin/ from a flat
v0.5.x tarball MUST re-install via the new tar xz →
ln -s flow above. Per F46: the v0.5.x flat-binary wheel
was unusable for cobrust run regardless because the
runtime + stdlib were not bundled (binary baked the GH
Actions runner workspace path). v0.6.0 fixes both sides.

Cobrust v0.6.1

Installation

v0.6.0 adopts the FHS-ish bin/lib/share wheel layout per
ADR-0069. Tarballs extract to a single self-contained
cobrust-v0.6.1/ directory.

Option A — cargo install (requires Rust toolchain)

cargo install --git https://github.com/Cobrust-lang/cobrust cobrust-cli

Option B — prebuilt wheel (no Rust needed; v0.6.0 layout)

Pick the tarball for your platform + CPU level, extract to a
stable location, and symlink the cobrust binary into your
$PATH. The runtime + stdlib live in lib/ + share/
siblings; do NOT move the binary out of its bin/ directory.

# macOS Apple Silicon M1 (tier-1)
curl -L https://github.com/Cobrust-lang/cobrust/releases/download/v0.6.1/cobrust-v0.6.1-aarch64-apple-darwin-m1.tar.gz | tar xz -C $HOME/.local/
ln -sf $HOME/.local/cobrust-v0.6.1/bin/cobrust $HOME/.local/bin/cobrust

# Linux x86_64 — glibc baseline (tier-1)
curl -L https://github.com/Cobrust-lang/cobrust/releases/download/v0.6.1/cobrust-v0.6.1-x86_64-unknown-linux-gnu-v1.tar.gz | tar xz -C $HOME/.local/
ln -sf $HOME/.local/cobrust-v0.6.1/bin/cobrust $HOME/.local/bin/cobrust

# Linux x86_64 — static musl (Alpine / distroless / minimal containers)
curl -L https://github.com/Cobrust-lang/cobrust/releases/download/v0.6.1/cobrust-v0.6.1-x86_64-unknown-linux-musl-v1.tar.gz | tar xz -C $HOME/.local/
ln -sf $HOME/.local/cobrust-v0.6.1/bin/cobrust $HOME/.local/bin/cobrust

Each wheel tarball bundles:

• bin/cobrust — main driver (also exposes cobrust lsp + cobrust dap subcommands per ADR-0068)
• bin/cobrust-lsp + bin/cobrust-dap — transitional shim binaries (deleted at v0.7.0; extension v0.1.x compat)
• lib/cobrust/libcobrust_stdlib.a — prebuilt static stdlib archive
• share/cobrust/runtime/{cobrust_main.c,cpu_features.c} — runtime C entrypoint + CPU feature helpers

Option C — Alpine / distroless container (musl static binary)

FROM alpine:latest
RUN apk add --no-cache curl tar
RUN curl -L https://github.com/Cobrust-lang/cobrust/releases/download/v0.6.1/cobrust-v0.6.1-x86_64-unknown-linux-musl-v1.tar.gz | tar xz -C /opt/ \
    && ln -s /opt/cobrust-v0.6.1/bin/cobrust /usr/local/bin/cobrust

Quick start

cobrust new hello && cd hello && cobrust run src/main.cb
# → hello, world

See Getting Started for the full guide.

Breaking change from v0.5.x

Users who manually cp cobrust /usr/local/bin/ from a flat
v0.5.x tarball MUST re-install via the new tar xz →
ln -s flow above. Per F46: the v0.5.x flat-binary wheel
was unusable for cobrust run regardless because the
runtime + stdlib were not bundled (binary baked the GH
Actions runner workspace path). v0.6.0 fixes both sides.

Cobrust v0.6.0

Installation

v0.6.0 adopts the FHS-ish bin/lib/share wheel layout per
ADR-0069. Tarballs extract to a single self-contained
cobrust-v0.6.0/ directory.

Option A — cargo install (requires Rust toolchain)

cargo install --git https://github.com/Cobrust-lang/cobrust cobrust-cli

Option B — prebuilt wheel (no Rust needed; v0.6.0 layout)

Pick the tarball for your platform + CPU level, extract to a
stable location, and symlink the cobrust binary into your
$PATH. The runtime + stdlib live in lib/ + share/
siblings; do NOT move the binary out of its bin/ directory.

# macOS Apple Silicon M1 (tier-1)
curl -L https://github.com/Cobrust-lang/cobrust/releases/download/v0.6.0/cobrust-v0.6.0-aarch64-apple-darwin-m1.tar.gz | tar xz -C $HOME/.local/
ln -sf $HOME/.local/cobrust-v0.6.0/bin/cobrust $HOME/.local/bin/cobrust

# Linux x86_64 — glibc baseline (tier-1)
curl -L https://github.com/Cobrust-lang/cobrust/releases/download/v0.6.0/cobrust-v0.6.0-x86_64-unknown-linux-gnu-v1.tar.gz | tar xz -C $HOME/.local/
ln -sf $HOME/.local/cobrust-v0.6.0/bin/cobrust $HOME/.local/bin/cobrust

# Linux x86_64 — static musl (Alpine / distroless / minimal containers)
curl -L https://github.com/Cobrust-lang/cobrust/releases/download/v0.6.0/cobrust-v0.6.0-x86_64-unknown-linux-musl-v1.tar.gz | tar xz -C $HOME/.local/
ln -sf $HOME/.local/cobrust-v0.6.0/bin/cobrust $HOME/.local/bin/cobrust

Each wheel tarball bundles:

• bin/cobrust — main driver (also exposes cobrust lsp + cobrust dap subcommands per ADR-0068)
• bin/cobrust-lsp + bin/cobrust-dap — transitional shim binaries (deleted at v0.7.0; extension v0.1.x compat)
• lib/cobrust/libcobrust_stdlib.a — prebuilt static stdlib archive
• share/cobrust/runtime/{cobrust_main.c,cpu_features.c} — runtime C entrypoint + CPU feature helpers

Option C — Alpine / distroless container (musl static binary)

FROM alpine:latest
RUN apk add --no-cache curl tar
RUN curl -L https://github.com/Cobrust-lang/cobrust/releases/download/v0.6.0/cobrust-v0.6.0-x86_64-unknown-linux-musl-v1.tar.gz | tar xz -C /opt/ \
    && ln -s /opt/cobrust-v0.6.0/bin/cobrust /usr/local/bin/cobrust

Quick start

cobrust new hello && cd hello && cobrust run src/main.cb
# → hello, world

See Getting Started for the full guide.

Breaking change from v0.5.x

Users who manually cp cobrust /usr/local/bin/ from a flat
v0.5.x tarball MUST re-install via the new tar xz →
ln -s flow above. Per F46: the v0.5.x flat-binary wheel
was unusable for cobrust run regardless because the
runtime + stdlib were not bundled (binary baked the GH
Actions runner workspace path). v0.6.0 fixes both sides.

Cobrust v0.5.2

Installation

Option A — cargo install (requires Rust toolchain)

cargo install --git https://github.com/Cobrust-lang/cobrust cobrust-cli
# (crates.io publish queued for v0.2.0)

Option B — prebuilt binary (no Rust needed)

# macOS arm64 (tier-1)
curl -L https://github.com/Cobrust-lang/cobrust/releases/download/v0.5.2/cobrust-v0.5.2-aarch64-apple-darwin.tar.gz | tar xz
sudo mv cobrust /usr/local/bin/

# Linux arm64 (tier-1)
curl -L https://github.com/Cobrust-lang/cobrust/releases/download/v0.5.2/cobrust-v0.5.2-aarch64-unknown-linux-gnu.tar.gz | tar xz
sudo mv cobrust /usr/local/bin/

# Linux x86_64 — glibc (tier-1)
curl -L https://github.com/Cobrust-lang/cobrust/releases/download/v0.5.2/cobrust-v0.5.2-x86_64-unknown-linux-gnu.tar.gz | tar xz
sudo mv cobrust /usr/local/bin/

# Linux x86_64 — static musl (tier-1, Alpine / distroless / minimal containers)
curl -L https://github.com/Cobrust-lang/cobrust/releases/download/v0.5.2/cobrust-v0.5.2-x86_64-unknown-linux-musl.tar.gz | tar xz
sudo mv cobrust /usr/local/bin/

Option C — Alpine / distroless container (musl static binary)

FROM alpine:latest
RUN apk add --no-cache curl tar
RUN curl -L https://github.com/Cobrust-lang/cobrust/releases/download/v0.5.2/cobrust-v0.5.2-x86_64-unknown-linux-musl.tar.gz | tar xz -C /usr/local/bin/

Quick start

cobrust new hello && cd hello && cobrust run src/main.cb
# → hello, world

See Getting Started for the full guide.

Cobrust v0.5.1

Installation

Option A — cargo install (requires Rust toolchain)

cargo install --git https://github.com/Cobrust-lang/cobrust cobrust-cli
# (crates.io publish queued for v0.2.0)

Option B — prebuilt binary (no Rust needed)

# macOS arm64 (tier-1)
curl -L https://github.com/Cobrust-lang/cobrust/releases/download/v0.5.1/cobrust-v0.5.1-aarch64-apple-darwin.tar.gz | tar xz
sudo mv cobrust /usr/local/bin/

# Linux arm64 (tier-1)
curl -L https://github.com/Cobrust-lang/cobrust/releases/download/v0.5.1/cobrust-v0.5.1-aarch64-unknown-linux-gnu.tar.gz | tar xz
sudo mv cobrust /usr/local/bin/

# Linux x86_64 — glibc (tier-1)
curl -L https://github.com/Cobrust-lang/cobrust/releases/download/v0.5.1/cobrust-v0.5.1-x86_64-unknown-linux-gnu.tar.gz | tar xz
sudo mv cobrust /usr/local/bin/

# Linux x86_64 — static musl (tier-1, Alpine / distroless / minimal containers)
curl -L https://github.com/Cobrust-lang/cobrust/releases/download/v0.5.1/cobrust-v0.5.1-x86_64-unknown-linux-musl.tar.gz | tar xz
sudo mv cobrust /usr/local/bin/

Option C — Alpine / distroless container (musl static binary)

FROM alpine:latest
RUN apk add --no-cache curl tar
RUN curl -L https://github.com/Cobrust-lang/cobrust/releases/download/v0.5.1/cobrust-v0.5.1-x86_64-unknown-linux-musl.tar.gz | tar xz -C /usr/local/bin/

Quick start

cobrust new hello && cd hello && cobrust run src/main.cb
# → hello, world

See Getting Started for the full guide.

Cobrust v0.5.0

Installation

Option A — cargo install (requires Rust toolchain)

cargo install --git https://github.com/Cobrust-lang/cobrust cobrust-cli
# (crates.io publish queued for v0.2.0)

Option B — prebuilt binary (no Rust needed)

# macOS arm64 (tier-1)
curl -L https://github.com/Cobrust-lang/cobrust/releases/download/v0.5.0/cobrust-v0.5.0-aarch64-apple-darwin.tar.gz | tar xz
sudo mv cobrust /usr/local/bin/

# Linux arm64 (tier-1)
curl -L https://github.com/Cobrust-lang/cobrust/releases/download/v0.5.0/cobrust-v0.5.0-aarch64-unknown-linux-gnu.tar.gz | tar xz
sudo mv cobrust /usr/local/bin/

# Linux x86_64 — glibc (tier-1)
curl -L https://github.com/Cobrust-lang/cobrust/releases/download/v0.5.0/cobrust-v0.5.0-x86_64-unknown-linux-gnu.tar.gz | tar xz
sudo mv cobrust /usr/local/bin/

# Linux x86_64 — static musl (tier-1, Alpine / distroless / minimal containers)
curl -L https://github.com/Cobrust-lang/cobrust/releases/download/v0.5.0/cobrust-v0.5.0-x86_64-unknown-linux-musl.tar.gz | tar xz
sudo mv cobrust /usr/local/bin/

Option C — Alpine / distroless container (musl static binary)

FROM alpine:latest
RUN apk add --no-cache curl tar
RUN curl -L https://github.com/Cobrust-lang/cobrust/releases/download/v0.5.0/cobrust-v0.5.0-x86_64-unknown-linux-musl.tar.gz | tar xz -C /usr/local/bin/

Quick start

cobrust new hello && cd hello && cobrust run src/main.cb
# → hello, world

See Getting Started for the full guide.

Cobrust v0.4.0

Installation

Option A — cargo install (requires Rust toolchain)

cargo install --git https://github.com/Cobrust-lang/cobrust cobrust-cli
# (crates.io publish queued for v0.2.0)

Option B — prebuilt binary (no Rust needed)

# macOS arm64 (tier-1)
curl -L https://github.com/Cobrust-lang/cobrust/releases/download/v0.4.0/cobrust-v0.4.0-aarch64-apple-darwin.tar.gz | tar xz
sudo mv cobrust /usr/local/bin/

# Linux arm64 (tier-1)
curl -L https://github.com/Cobrust-lang/cobrust/releases/download/v0.4.0/cobrust-v0.4.0-aarch64-unknown-linux-gnu.tar.gz | tar xz
sudo mv cobrust /usr/local/bin/

# Linux x86_64 — glibc (tier-1)
curl -L https://github.com/Cobrust-lang/cobrust/releases/download/v0.4.0/cobrust-v0.4.0-x86_64-unknown-linux-gnu.tar.gz | tar xz
sudo mv cobrust /usr/local/bin/

# Linux x86_64 — static musl (tier-1, Alpine / distroless / minimal containers)
curl -L https://github.com/Cobrust-lang/cobrust/releases/download/v0.4.0/cobrust-v0.4.0-x86_64-unknown-linux-musl.tar.gz | tar xz
sudo mv cobrust /usr/local/bin/

Option C — Alpine / distroless container (musl static binary)

FROM alpine:latest
RUN apk add --no-cache curl tar
RUN curl -L https://github.com/Cobrust-lang/cobrust/releases/download/v0.4.0/cobrust-v0.4.0-x86_64-unknown-linux-musl.tar.gz | tar xz -C /usr/local/bin/

Quick start

cobrust new hello && cd hello && cobrust run src/main.cb
# → hello, world

See Getting Started for the full guide.

Cobrust v0.4.0-rc1

Installation

Option A — cargo install (requires Rust toolchain)

cargo install --git https://github.com/Cobrust-lang/cobrust cobrust-cli
# (crates.io publish queued for v0.2.0)

Option B — prebuilt binary (no Rust needed)

# macOS arm64 (tier-1)
curl -L https://github.com/Cobrust-lang/cobrust/releases/download/v0.4.0-rc1/cobrust-v0.4.0-rc1-aarch64-apple-darwin.tar.gz | tar xz
sudo mv cobrust /usr/local/bin/

# Linux arm64 (tier-1)
curl -L https://github.com/Cobrust-lang/cobrust/releases/download/v0.4.0-rc1/cobrust-v0.4.0-rc1-aarch64-unknown-linux-gnu.tar.gz | tar xz
sudo mv cobrust /usr/local/bin/

# Linux x86_64 — glibc (tier-1)
curl -L https://github.com/Cobrust-lang/cobrust/releases/download/v0.4.0-rc1/cobrust-v0.4.0-rc1-x86_64-unknown-linux-gnu.tar.gz | tar xz
sudo mv cobrust /usr/local/bin/

# Linux x86_64 — static musl (tier-1, Alpine / distroless / minimal containers)
curl -L https://github.com/Cobrust-lang/cobrust/releases/download/v0.4.0-rc1/cobrust-v0.4.0-rc1-x86_64-unknown-linux-musl.tar.gz | tar xz
sudo mv cobrust /usr/local/bin/

Option C — Alpine / distroless container (musl static binary)

FROM alpine:latest
RUN apk add --no-cache curl tar
RUN curl -L https://github.com/Cobrust-lang/cobrust/releases/download/v0.4.0-rc1/cobrust-v0.4.0-rc1-x86_64-unknown-linux-musl.tar.gz | tar xz -C /usr/local/bin/

Quick start

cobrust new hello && cd hello && cobrust run src/main.cb
# → hello, world

See Getting Started for the full guide.

Cobrust v0.3.0

Installation

Option A — cargo install (requires Rust toolchain)

cargo install --git https://github.com/Cobrust-lang/cobrust cobrust-cli
# (crates.io publish queued for v0.2.0)

Option B — prebuilt binary (no Rust needed)

# macOS arm64 (tier-1)
curl -L https://github.com/Cobrust-lang/cobrust/releases/download/v0.3.0/cobrust-v0.3.0-aarch64-apple-darwin.tar.gz | tar xz
sudo mv cobrust /usr/local/bin/

# Linux arm64 (tier-1)
curl -L https://github.com/Cobrust-lang/cobrust/releases/download/v0.3.0/cobrust-v0.3.0-aarch64-unknown-linux-gnu.tar.gz | tar xz
sudo mv cobrust /usr/local/bin/

# Linux x86_64 (tier-1)
curl -L https://github.com/Cobrust-lang/cobrust/releases/download/v0.3.0/cobrust-v0.3.0-x86_64-unknown-linux-gnu.tar.gz | tar xz
sudo mv cobrust /usr/local/bin/

Quick start

cobrust new hello && cd hello && cobrust run src/main.cb
# → hello, world

See Getting Started for the full guide.