sno-cli

1# Sno CLI
2 
3`sno` is one binary. This file carries the rules, the task map and the recipes. The exact
4commands and flags of the version that is installed are served by the binary itself, so they
5cannot be out of date.
6 
7## Start Here
8 
9Choose the executable once and keep using it:
10 
11- Use the absolute path the installer printed.
12- Otherwise run `type -a sno` (works in bash and zsh). If two `sno` files are listed, or the version is older
13  than the installer said, tell the owner, use the newer absolute path, and note that a
14  running shell may need `hash -r` or a new terminal.
15- If `sno` is not installed, say so. Do not look for its source.
16 
17In every command block, `sno` stands for that absolute executable. Then read the reference
18for this exact version, once:
19 
20```text
21sno --version
22sno
23```
24 
25`sno` alone prints the list of commands. Before you use a command, read `sno <command> --help`
26(for a nested command, `sno <group> <command> --help`). That output comes from the installed
27binary, so it is the authority for every flag.
28 
29## Conventions
30 
31- Pass `--json` when you parse the output. Stdout is then exactly one JSON value.
32- A command you typed incompletely or inexactly is completed, or answered, instead of failing:
33  - Unique prefixes of subcommands and flags work: typing sno stat runs sno station.
34  - A missing value gets a default, and a note says which (`notes` in JSON, the first line in text).
35…