amql-cli 0.0.0-alpha.0

AQL command-line interface and REPL
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

# amql-cli

> Command-line interface and interactive REPL for AQL

## Role

- Thin shim over [amql-engine](../amql-engine)
- Zero domain logic — all operations delegate to the engine
- Also exposes the [MCP server](../amql-mcp-server) via `aql mcp`

## Commands

| Command | Description |
|---------|-------------|
| `select` | Query annotations by CSS-like selector |
| `query` | Unified annotation + code element query |
| `extract` | Run extractors on source files |
| `validate` | Validate annotations against schema |
| `diff` | Compare annotations against baseline |
| `repair` | Suggest fixes for annotation issues |
| `schema` | Discover annotation metadata |
| `stats` | Project annotation statistics |
| `init` | Initialize AQL in a project |
| `locate` | Find sidecar for a source file |
| `bench` | Benchmark AQL vs baseline tools |
| `nav_select` | Select AST nodes by tree-sitter kind |
| `nav_read` | Read source text of a node |
| `nav_insert` | Insert source relative to a node |
| `nav_replace` | Replace a node's source text |
| `nav_remove` | Remove a node from source |
| `transact` | Atomic multi-step source mutation |
| `mcp` | Start the MCP server (stdio transport) |

## Getting Started

```sh
# Install
cargo install amql-cli

# Query annotations
aql select "controller[method='POST']" --scope src/

# Interactive REPL
aql

# Start MCP server
aql mcp
```

## License

[MIT](../../LICENSE)