https://github.com/aspect-build/aspect-cli
{ Correct, Fast, Usable } -- Choose three
https://github.com/aspect-build/aspect-cli
bazel cli
Last synced: 21 days ago
JSON representation
{ Correct, Fast, Usable } -- Choose three
- Host: GitHub
- URL: https://github.com/aspect-build/aspect-cli
- Owner: aspect-build
- License: apache-2.0
- Created: 2021-06-12T21:05:04.000Z (about 5 years ago)
- Default Branch: main
- Last Pushed: 2026-05-27T07:15:08.000Z (24 days ago)
- Last Synced: 2026-05-27T07:23:03.880Z (24 days ago)
- Topics: bazel, cli
- Language: Starlark
- Homepage: https://aspect.build/
- Size: 9.38 MB
- Stars: 158
- Watchers: 10
- Forks: 43
- Open Issues: 22
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Aspect CLI
Aspect CLI is a programmable task runner built on top of Bazel that "just fits" with your repository and developer workflows.
## Bazel's Shortcoming
Bazel is Google's powerful polyglot build system.
It's excellent at loading a dependency graph from package declarations (`query`/`cquery`), and analyzing an action graph from rule implementations (`aquery`).
It also has powerful and scalable execution for building action outputs and test results (`build`&`test`).
Bazel is extensible, but only for defining build rules that produce additional output files.
It falls short on customizing developer workflows.
In fact the Bazel commands not mentioned above are not-so-excellent attempts at adding a few developer workflows for use within Google.
The fact that many companies have scripted around Bazel, and the local development scripts drift from the CI testing scripts, show that something is missing: a "task runner" layer on top of `query` and `build` primitives.
## Introducing Aspect CLI
Aspect CLI lets you program custom commands using Aspect Extension Language (AXL), a Starlark dialect, for robust, maintainable workflows.
Say goodbye to brittle Bash wrappers and delete your `Makefile`.
- New engineers on the team don't struggle to setup their machine and run the series of commands to get a working build or reproduce what happened on CI.
- Product engineers finally regain control over their own productivity.
- Developer Infrastructure teams can stop chasing reports of misbehavior on CI and integrate great tooling into every developers routine.
Whether you're streamlining CI/CD, enforcing code standards, or integrating tools, Aspect CLI boosts productivity. It's fast, safe, and open source—try it today and transform how your team builds!
## Extensions
We publish extensions to https://github.com/aspect-extensions.
You can also search for the `aspect-extensions` topic:
http://github.com/topics/aspect-extensions
You can write your own extensions as well. See the documentation.
## Comparison to older versions
> [!NOTE]
> This is a Rust rewrite, superseding the legacy Go version that was published in version 2025.41 and earlier.
> The older implementation is now in maintenance mode at [aspect-build/aspect-cli-legacy](https://github.com/aspect-build/aspect-cli-legacy).
Versions before 2025.42 differed in some notable ways:
- Older versions shadowed the `bazel` command in our recommended installation, using homebrew or bazeliskrc to override `bazel`.
Now `aspect` works alongside `bazel`.
- The plugin system used a gRPC client/server protocol. Now `aspect` uses a Starlark dialect called "Aspect Extension Language".
- Older versions included a fully pre-compiled Gazelle binary along with some Gazelle extensions, using the `configure` command. This has moved to a standalone repo: https://github.com/aspect-build/aspect-gazelle
## Licenses
Aspect CLI is licensed under [Apache 2](./LICENSE).
## For Enterprise
Built by [Aspect](http://aspect.build). Explore our products for advanced features.