auberge 0.15.16

CLI tool for managing self-hosted infrastructure with Ansible
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
74
75
76
77
78
79
80
81
82
83
84
85
86

# auberge config

Manage user configuration

## Usage

```bash
auberge config <COMMAND>
# Alias: auberge c
```

## Subcommands

| Command | Alias | Description                                                |
| ------- | ----- | ---------------------------------------------------------- |
| init    | i     | Print a config.toml scaffold derived from the Key Registry |
| set     | s     | Set a config value                                         |
| get     | g     | Get a config value                                         |
| list    | l     | List all config keys (sensitive values redacted)           |
| remove  | rm    | Remove a key from config                                   |
| edit    | e     | Open config in $EDITOR                                     |
| path    | p     | Print config file path                                     |

### `init` flags

| Flag                  | Description                                                              |
| --------------------- | ------------------------------------------------------------------------ |
| `--playbooks <a,b,c>` | Emit only keys in the union of the named Playbook Metas' `required_keys` |
| `--output, -o <path>` | Write the scaffold to a file (refuses to overwrite without `--force`)    |
| `--force, -f`         | Overwrite the output file if it exists                                   |

### `get` flags

| Flag         | Description                                                                              |
| ------------ | ---------------------------------------------------------------------------------------- |
| `--resolved` | Execute `!`-prefixed command references and print the resolved value (may print secrets) |

By default `get` prints the raw stored value — a key stored as `!pa show foo` prints that literal string. With `--resolved`, the reference is executed exactly as deploy resolves it (`!!` escapes to a literal `!`, output is whitespace-trimmed, and a failing or empty command exits non-zero without printing the raw value).

## Interactive Selection

When `key` is omitted from `set`, `get`, or `remove`, an interactive fuzzy-search selector appears (requires a TTY). For `set`, the value is also prompted interactively if omitted.

In non-interactive mode (pipes, scripts), a key argument is required for `get` and `remove`, and both key and value are required for `set`.

## Examples

```bash
# Print full scaffold to stdout
auberge config init

# Generate config.toml at the XDG config path
auberge config init --output "$(auberge config path)"

# Scope the scaffold to specific playbooks
auberge config init --playbooks paperless,navidrome

# Overwrite an existing file
auberge config init --output config.toml --force

# Set a value directly
auberge c s admin_user_name myuser

# Set interactively (select key, then type value)
auberge c s

# List all keys
auberge c l

# Get a specific value
auberge c g domain

# Resolve a !-command reference (prints the secret, not the ref)
auberge c g restic_password --resolved

# Get interactively (select key from list)
auberge c g

# Remove interactively
auberge c rm

# Edit in your editor
auberge c e
```

Use `auberge config --help` for full options.