aa-cli 0.0.1-rc.2

aasm — command-line tool for Agent Assembly
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73

# aa-cli

`aasm` — the command-line tool for Agent Assembly.

[![crates.io](https://img.shields.io/crates/v/aa-cli?logo=rust&label=crates.io)](https://crates.io/crates/aa-cli)
[![docs.rs](https://img.shields.io/docsrs/aa-cli?logo=docsdotrs&label=docs.rs)](https://docs.rs/aa-cli)
[![License](https://img.shields.io/badge/license-Apache--2.0-blue?logo=apache)](../LICENSE)
[![Rust](https://img.shields.io/badge/rust-%E2%89%A51.75-orange?logo=rust)](https://www.rust-lang.org)

## What is this

`aa-cli` is the operator front-end for [Agent Assembly](https://github.com/ai-agent-assembly/agent-assembly),
the governance-native runtime for AI agents. It ships the **`aasm`** binary — the
terminal entry point for inspecting agent topology, managing policies, watching
the audit trail, and driving the governance gateway.

Agent Assembly enforces governance across three independently-deployable
interception layers (in-process SDK shim, sidecar proxy, and eBPF). `aasm` is how
an operator observes and controls that system from the command line, talking to
the gateway over its HTTP/OpenAPI surface.

## Install

The recommended way to get the `aasm` binary is the one-line installer, which
downloads the matching pre-built release tarball, verifies its checksum, and
installs to `~/.local/bin`:

```sh
curl -fsSL https://agent-assembly.com/install.sh | sh
```

Pin a specific version with `AASM_VERSION`:

```sh
AASM_VERSION=v0.0.1-beta.4 curl -sSf https://agent-assembly.com/install.sh | sh
```

Or build/install from source via cargo:

```sh
cargo install aa-cli
```

Then confirm the install:

```sh
aasm --help
```

## Usage

```sh
# Show the agent topology
aasm topology

# Manage governance policies
aasm policy --help

# Launch the operator dashboard (TUI)
aasm dashboard

# Tail the audit log
aasm audit
```

Run `aasm <command> --help` for the full set of subcommands (`agent`, `policy`,
`audit`, `budget`, `cost`, `gateway`, `proxy`, `sandbox`, `topology`, and more).

## Links

- Documentation: <https://docs.agent-assembly.com/>
- Source: <https://github.com/ai-agent-assembly/agent-assembly>
- License: [Apache-2.0](../LICENSE)