cross-rs/cross
53.6
Adequate · 14 November 2026
15.3k
lines of production code
Rust
with Python
5
measurements over time
What this system is
Features
Add ARMv6 hard-float and LoongArch64 cross-compilation configurations
New crosstool-ng configuration files are introduced to support building toolchains for ARMv6 hard-float (arm-unknown-linux-gnueabihf) and LoongArch64 architectures (loongarch64-unknown-linux-gnu and loongarch64-unknown-linux-musl). Users can now generate cross-compilers targeting ARMv6 with hardware floating-point support, as well as LoongArch64 systems using either the GNU libc or the musl libc.
crosstool-ng · high confidence
Introduce cross-util binary and refine cross fallback behavior
A new \cross-util\ binary is added to manage cross-related Docker resources (images, volumes, containers, and clean operations) via subcommands. The main \cross\ binary now explicitly handles fallback to the host \cargo\ when cross compilation is not required, ensuring that the host cargo's exit code is correctly propagated and that warnings/errors in CI or when \CROSS\_NO\_WARNINGS=1\ is set cause an early exit rather than silent fallback.
src/bin · high confidence
Introduce xtask CLI for build, CI, and changelog management
The \xtask\ subcommand tool is now available for managing the project's development workflow. It includes \build-docker-image\ to construct and push cross-compilation Docker images with support for cache options (\--cache-from\, \--cache-to\) and custom build arguments, \ci-job\ to provide metadata and validation for CI pipelines (such as checking tag versions against Cargo.toml), \changelog\ to build and validate release notes from JSON entries, and \codegen\ to auto-generate the list of provided Docker images. Additionally, \install-git-hooks\ sets up pre-commit and pre-push scripts to run checks and tests automatically.
xtask/src · high confidence
New cross-util subcommands for managing Docker resources and running commands
The \cross-util\ CLI now includes dedicated subcommands to manage Docker containers, images, and volumes, as well as to run arbitrary commands inside containers. Users can list, create, remove, and prune data volumes and containers, and list or remove Docker images (including custom images) with support for JSON output. A new \run\ subcommand allows executing arbitrary shell commands within a cross-compilation container, supporting interactive sessions and specific target selection. These changes consolidate resource management and debugging capabilities into the \cross-util\ tool.
src/bin/commands · high confidence
Repository initialization with project configuration and documentation
The repository has been initialized with essential project configuration files, including \.editorconfig\ for consistent code formatting, \clippy.toml\ to disallow \Path::display\ in favor of safer Unicode handling, and \deny.toml\ to enforce dependency and license policies. The \README.md\ has been updated to reflect the project's move to the cross-rs organization, clarifying that it supports both Docker and Podman, and providing updated installation and usage instructions. Additionally, standard governance documents such as \CODE\_OF\_CONDUCT.md\ and \CONTRIBUTING.md\ have been added, along with license files (\LICENSE-APACHE\, \LICENSE-MIT\).
(repo-wide) · high confidence
Behavioural changes
Complete source rewrite and architectural refactor
The \src\ directory has been completely rewritten, replacing the previous single-file \main.rs\ and \docker.rs\ implementation with a modular library structure. This change introduces a new configuration system using \Cross.toml\ and \Cargo.toml\ metadata (via \cross\_toml.rs\ and \config.rs\), a dedicated CLI argument parser (\cli.rs\), and a new shell output system (\shell.rs\) with verbosity and color support. The build process now includes a build script (\build.rs\) to embed commit information and handle sandboxing flags, while path handling is abstracted into \file.rs\ to support Windows POSIX conversions. This refactor shifts the tool from a simple wrapper to a structured application with distinct modules for cargo interaction, docker management, and configuration parsing.
src · high confidence
Docker images updated to Ubuntu 24.04 base
The Docker images for all supported cross-compilation targets have been updated to use Ubuntu 24.04 as their base operating system. This change affects the underlying environment for building Rust code for various architectures, including Linux, Android, FreeBSD, and Windows (via Wine).
docker · high confidence
Docker integration refactored with engine-specific ignore files and build options
The Docker module has been restructured into dedicated files (build, custom, engine, image, local, remote, shared) to improve maintainability. Users can now use \.containerignore\ for Podman and \.dockerignore\ for Docker, with automatic selection and warnings if the wrong file is used. Custom Dockerfile builds now support explicit \--output\ flags and progress control via the \CROSS\_BUILD\_PROGRESS\ environment variable. The engine detection logic has been updated to better handle rootless containers and remote execution, and the \seccomp.json\ profile is now included to restrict container capabilities.
src/docker · high confidence
Granular CI target filtering via labels and \`/ci try\` command
The CI system now supports more precise control over which build targets and tests are executed. Users can use the \/ci try\ command to trigger checks on specific pull requests, with options to specify tests, enable verbose output, or enable cross-debugging. Additionally, CI jobs can be filtered by PR labels (e.g., \CI-\ prefixed labels) to run only relevant targets, and the \no-ci-tests\ label allows skipping tests entirely. This replaces the previous bors-based workflow with a more flexible, label-driven matrix generation approach.
xtask/src/ci · high confidence
New CI test suite and build infrastructure for Cross
The CI system has been restructured with a new set of shell scripts to validate Cross functionality. The \build\_release.sh\ script handles release builds, including a specific workaround for glibc version mismatches on the x86\_64-unknown-linux-gnu target. A shared library (\shared.sh\) provides common utilities like retry logic and binary path resolution. The test suite now includes dedicated scripts for verifying Docker-in-Docker execution, remote Docker support, Podman compatibility, and the use of custom or foreign toolchains (such as Alpine and Ubuntu images). Additionally, new tests cover the Zig-based cross-compilation image and the \cargo-bisect-rustc\ integration, ensuring these specific features work correctly in the CI environment.
ci · high confidence
Test coverage
Added tests for rustup toolchain parsing and TOML fence validation
New test files were added to verify core functionality: \src/tests/rustup.rs\ tests the \remove\_toolchain\_suffixes\ function to ensure toolchain names are correctly parsed from rustup output strings, handling both active and default overrides. \src/tests/toml.rs\ adds a CI check that scans markdown files for TOML code fences, validating that the contained configuration snippets can be successfully parsed by the \CrossToml\ parser and round-trip through JSON serialization.
src/tests · high confidence
Dependencies
Major dependency overhaul and project restructuring
The project has undergone a significant dependency update, upgrading the Rust edition to 2024 and the MSRV to 1.85.0. Key library changes include replacing \error-chain\ with \thiserror\, \atty\ with \is-terminal\, and \walkdir\ with \ripgrep\'s \ignore\ crate (though \walkdir\ remains optional). The CLI framework has been upgraded from clap 3 to clap 4, and error reporting now uses \color-eyre\. Additionally, a new \xtask\ workspace member was added for build automation, and the main package version was bumped to 0.2.5.
(dependencies) · high confidence
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
How this codebase got here
Score
- CAI 61 → 54 (-7.6)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.4) — scores are not directly comparable.
Lenses
- Code Health 94 → 90 (-4.3)
- Architecture 96 → 96 (+0.0)
- Maturity 56 → 59 (+2.8)
- Readiness 58 → 57 (-0.2)
- Security 57 → 40 (-17.1)
Resolved (17)
- Concentrated knowledge decay
- Duplicated block (27 lines × 2) (src/cross_toml.rs)
- Most significant orphaned file (src/config.rs)
- Most significant orphaned file (src/cross_toml.rs)
- No ADRs found
- Off-boarding risk: anonymized user #1
- Orphaned file (src/cargo.rs)
- Orphaned file (src/docker/custom.rs)
- Orphaned file (src/docker/engine.rs)
- Orphaned file (src/errors.rs)
- Orphaned file (src/file.rs)
- Orphaned file (src/rustc.rs)
- Orphaned file (src/rustup.rs)
- Orphaned file (src/tests.rs)
- Orphaned file (xtask/src/main.rs)
- Orphaned file (xtask/src/target_info.rs)
- Orphaned file (xtask/src/util.rs)
New (37)
- Duplicated block (27 lines × 2) (src/cross_toml.rs)
- Edited copies of one member (3 members, 50+ corresponding lines) (src/cross_toml.rs)
- Edited copy of a member (10 corresponding lines) (xtask/src/ci/target_matrix.rs)
- Edited copy of a member (11 corresponding lines) (src/temp.rs)
- Edited copy of a member (15 corresponding lines) (src/bin/commands/containers.rs)
- Edited copy of a member (16 corresponding lines) (xtask/src/hooks.rs)
- Edited copy of a member (19 corresponding lines) (xtask/src/hooks.rs)
- Edited copy of a member (8 corresponding lines) (src/bin/cross-util.rs)
- Further orphaned files (smaller)
- Low coverage: src/cargo.rs (src/cargo.rs)
- Low coverage: src/cli.rs (src/cli.rs)
- Low coverage: src/docker/custom.rs (src/docker/custom.rs)
- Low coverage: src/docker/local.rs (src/docker/local.rs)
- Low coverage: src/docker/mod.rs (src/docker/mod.rs)
- Low coverage: src/docker/remote.rs (src/docker/remote.rs)
- Low coverage: src/docker/shared.rs (src/docker/shared.rs)
- Low coverage: src/errors.rs (src/errors.rs)
- Low coverage: src/extensions.rs (src/extensions.rs)
- Low coverage: src/id.rs (src/id.rs)
- Low coverage: src/interpreter.rs (src/interpreter.rs)
- …and 17 more
Changes since last survey
- 5 commits — 5 feature/other, 0 fixes
By area
- (repo) — 3 commits
- docker/zig.sh — 1 commit
- src/docker — 1 commit
Notable commits
- change: docker/zig.sh: restore the executable bit
- change: docker/zig.sh: restore the executable bit (#1817)
- change: enh(linux-runner): use kernel meta packages (#1813)
- change: find container root on containerd image store
- change: find container root on containerd image store (#1816)
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
cross-rs/cross was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.
About this page
- The score is its most recent published measurement, taken on 14 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
- Measured at commit a9301e91f72bba3850460512685f6b16062015ff — the exact code this score is about.
- Scored under rubric-2026.11.4 — the same rubric and the same method as every other entry in this index.
- Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.65+preprod-e1a3b69fc8ee.