jan-cli 0.16.0

YAML-defined CLI trees with progressive help, optional exec aliases, merged extra specs, and SQLite audit logging keyed by git branch
Documentation 
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

# Examples in this repo

All commands assume you are in `jan-cli/` (or pass absolute paths to `jan use`).

## Nested demo (`examples/demo.spec.yaml`)

Progressive help, passthrough, `requires` / `path`, and a `tests:` example:

```bash
jan use examples --root demo.spec.yaml
jan android skills list
jan android skills search -- foo
jan test android
```

## Tooling shortcuts (`examples/default.spec.yaml`)

Git, disk, net, proc, gradle, rust, android, docker, and sys fragments via `include:`:

```bash
jan use examples --root default.spec.yaml
jan git s
jan git r rev-parse --is-inside-work-tree
jan git --help
```

## Packages (`examples/packages.spec.yaml`)

Pinned uv / pnpm / gradle plus language `exec` forms. Run with `--cwd examples` so relative CSV / script paths resolve.

```bash
jan use examples --root packages.spec.yaml
jan --cwd examples summarize-sales run
jan --cwd examples summarize-sales run --product gadget
jan --cwd examples pin-report run
jan --cwd examples pin-report cow
jan --cwd examples kotlin-greet run --name Ada
jan packages
```

| Command | Demonstrates |
|---------|----------------|
| `summarize-sales` | `packages.uv: [pandas==…]`, typed `file` input, `exec.text` help, inlined Python via `argv` |
| `pin-report` | `packages.pnpm` exact versions, `NODE_PATH`, `.bin` on PATH |
| `kotlin-greet` | `packages.gradle` Maven coord, `exec.kotlin` `.kts` |

Cold builds need `uv`, `pnpm`, and/or `gradle` on PATH (`kotlinc` for the Kotlin example).