# aspect-cli

This is the frontend for the Aspect build tool. It is currently just a wrapper
around bazelisk or bazel, meant to install in tools/bazel.

In the future, we might totally replace the bazel C++ client, and this tool
would be a gRPC client of the bazel server.

## TODOs

- [ ] figure out how to cut and host a release GH Action to cut/publish release
      whenever a tag is pushed upstream
- [ ] document lots of ways to install, including a bash one-liner
- [ ] help user ensure bash/zsh completion working
- [ ] warn user if Bazel version is floating (no bazelisk, or using latest in
      .bazelversion, or no .bazelversion)

# Use Cases

## When I am confused by bazel

I can find that Aspect is an easier-to-use wrapper and feel motivated and
comfortable to try it immediately.

From aspect.build/install I quickly pick an Installation option, and am guided
through to successful install.

The first time I run `aspect` in interactive mode,

- I choose whether I want to install for all users of my workspace, in which
  case a bootstrap bit is added to tools/bazel ensuring that the tool is
  downloaded and spawned for anyone cloning my repo.

## When I run bare `bazel`

## When I run bare `bazel build`

## When I run bare `bazel test`