@hideandseeklab/aoox 0.1.0-alpha.1 → 0.1.0-alpha.11

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (105) hide show
  1. package/README.md +727 -68
  2. package/assets/install/README.md +4 -0
  3. package/assets/install/docker-compose.dist.yml +17 -0
  4. package/dist/commands/deploy.js +33 -33
  5. package/dist/commands/domain/set.d.ts +1 -1
  6. package/dist/commands/domain/set.js +21 -10
  7. package/dist/commands/env/diff.d.ts +18 -0
  8. package/dist/commands/env/diff.js +51 -0
  9. package/dist/commands/env/history.d.ts +17 -0
  10. package/dist/commands/env/history.js +48 -0
  11. package/dist/commands/env/link.d.ts +17 -0
  12. package/dist/commands/env/link.js +53 -0
  13. package/dist/commands/env/links.d.ts +14 -0
  14. package/dist/commands/env/links.js +17 -0
  15. package/dist/commands/env/list.d.ts +40 -0
  16. package/dist/commands/env/list.js +120 -0
  17. package/dist/commands/env/promote.d.ts +20 -0
  18. package/dist/commands/env/promote.js +95 -0
  19. package/dist/commands/env/pull.d.ts +17 -0
  20. package/dist/commands/env/pull.js +68 -0
  21. package/dist/commands/env/push.d.ts +17 -0
  22. package/dist/commands/env/push.js +69 -0
  23. package/dist/commands/env/set.d.ts +19 -0
  24. package/dist/commands/env/set.js +59 -0
  25. package/dist/commands/env/unlink.d.ts +17 -0
  26. package/dist/commands/env/unlink.js +39 -0
  27. package/dist/commands/env/unset.d.ts +18 -0
  28. package/dist/commands/env/unset.js +44 -0
  29. package/dist/commands/install.d.ts +4 -0
  30. package/dist/commands/install.js +84 -31
  31. package/dist/commands/link.js +20 -18
  32. package/dist/commands/login.d.ts +2 -0
  33. package/dist/commands/login.js +64 -16
  34. package/dist/commands/registry/build.d.ts +24 -0
  35. package/dist/commands/registry/build.js +42 -0
  36. package/dist/commands/registry/domain.js +11 -9
  37. package/dist/commands/registry/push.d.ts +19 -0
  38. package/dist/commands/registry/push.js +31 -0
  39. package/dist/commands/reinstall.d.ts +25 -0
  40. package/dist/commands/reinstall.js +235 -0
  41. package/dist/commands/run.d.ts +23 -0
  42. package/dist/commands/run.js +158 -0
  43. package/dist/commands/update/panel.d.ts +18 -0
  44. package/dist/commands/update/panel.js +62 -0
  45. package/dist/commands/update.d.ts +4 -5
  46. package/dist/commands/update.js +54 -40
  47. package/dist/commands/whoami.js +5 -3
  48. package/dist/help.d.ts +9 -0
  49. package/dist/help.js +16 -0
  50. package/dist/lib/api.d.ts +1 -1
  51. package/dist/lib/api.js +2 -2
  52. package/dist/lib/config.d.ts +5 -1
  53. package/dist/lib/config.js +9 -5
  54. package/dist/lib/connection-summary.d.ts +30 -0
  55. package/dist/lib/connection-summary.js +105 -0
  56. package/dist/lib/discovery.d.ts +47 -0
  57. package/dist/lib/discovery.js +222 -0
  58. package/dist/lib/docker.d.ts +10 -0
  59. package/dist/lib/docker.js +44 -2
  60. package/dist/lib/env-command.d.ts +109 -0
  61. package/dist/lib/env-command.js +229 -0
  62. package/dist/lib/env-file.d.ts +21 -0
  63. package/dist/lib/env-file.js +61 -0
  64. package/dist/lib/env-plan.d.ts +23 -0
  65. package/dist/lib/env-plan.js +34 -0
  66. package/dist/lib/env-run.d.ts +24 -0
  67. package/dist/lib/env-run.js +56 -0
  68. package/dist/lib/env-text.d.ts +97 -0
  69. package/dist/lib/env-text.js +266 -0
  70. package/dist/lib/flags.d.ts +7 -0
  71. package/dist/lib/flags.js +19 -4
  72. package/dist/lib/image-ref.d.ts +16 -0
  73. package/dist/lib/image-ref.js +66 -0
  74. package/dist/lib/install-env.d.ts +21 -0
  75. package/dist/lib/install-env.js +19 -1
  76. package/dist/lib/link-command.d.ts +9 -0
  77. package/dist/lib/link-command.js +23 -0
  78. package/dist/lib/link.js +2 -2
  79. package/dist/lib/outdated.d.ts +9 -0
  80. package/dist/lib/outdated.js +23 -0
  81. package/dist/lib/panel-addresses.d.ts +35 -0
  82. package/dist/lib/panel-addresses.js +122 -0
  83. package/dist/lib/registry-check.d.ts +35 -0
  84. package/dist/lib/registry-check.js +102 -0
  85. package/dist/lib/registry-image-command.d.ts +40 -0
  86. package/dist/lib/registry-image-command.js +146 -0
  87. package/dist/lib/registry-select.d.ts +21 -0
  88. package/dist/lib/registry-select.js +48 -0
  89. package/dist/lib/reinstall.d.ts +66 -0
  90. package/dist/lib/reinstall.js +204 -0
  91. package/dist/lib/run-banner.d.ts +27 -0
  92. package/dist/lib/run-banner.js +41 -0
  93. package/dist/lib/self-update.d.ts +30 -0
  94. package/dist/lib/self-update.js +94 -0
  95. package/dist/lib/system.d.ts +2 -0
  96. package/dist/lib/system.js +23 -2
  97. package/dist/lib/terminal-key.d.ts +74 -0
  98. package/dist/lib/terminal-key.js +147 -0
  99. package/dist/lib/types.d.ts +132 -0
  100. package/dist/lib/variable-sets.d.ts +90 -0
  101. package/dist/lib/variable-sets.js +177 -0
  102. package/dist/lib/version.d.ts +7 -0
  103. package/dist/lib/version.js +57 -0
  104. package/oclif.manifest.json +1422 -56
  105. package/package.json +47 -12
package/README.md CHANGED
@@ -3,6 +3,12 @@ aoox
3
3
 
4
4
  CLI for [aoox](https://github.com/hideandseeklab/aoox-api), a self-hosted PaaS — build and deploy
5
5
 
6
+ Website: [aoox.dev](https://aoox.dev) · Docs: [aoox.dev/docs](https://aoox.dev/docs) · Changelog: [aoox.dev/changelog](https://aoox.dev/changelog)
7
+
8
+ Related repos: [aoox-api](https://github.com/hideandseeklab/aoox-api) (backend) ·
9
+ [aoox-web](https://github.com/hideandseeklab/aoox-web) (dashboard) ·
10
+ [aoox-landing](https://github.com/hideandseeklab/aoox-landing) (website and docs).
11
+
6
12
 
7
13
  [![oclif](https://img.shields.io/badge/cli-oclif-brightgreen.svg)](https://oclif.io)
8
14
  [![Version](https://img.shields.io/npm/v/%40hideandseeklab%2Faoox.svg)](https://npmjs.org/package/@hideandseeklab/aoox)
@@ -21,7 +27,7 @@ $ npm install -g @hideandseeklab/aoox
21
27
  $ aoox COMMAND
22
28
  running command...
23
29
  $ aoox (--version)
24
- @hideandseeklab/aoox/0.1.0-alpha.1 linux-x64 node-v24.21.0
30
+ @hideandseeklab/aoox/0.1.0-alpha.11 linux-x64 node-v24.21.0
25
31
  $ aoox --help [COMMAND]
26
32
  USAGE
27
33
  $ aoox COMMAND
@@ -31,17 +37,38 @@ USAGE
31
37
 
32
38
  # Installation
33
39
 
34
- `aoox` is still in **alpha** — published to npm under the `alpha` dist-tag, not `latest`
35
- (the package has never had a stable release, so `npm install -g @hideandseeklab/aoox` without a
36
- tag will fail to find a version). Install explicitly with this tag:
40
+ ## Linux / macOS (no Node.js required)
41
+
42
+ A standalone install script downloads a tarball with its own bundled Node.js runtime — nothing
43
+ to install first, works even on a machine that will never otherwise touch Node.js (e.g. a bare
44
+ VPS before running `aoox install` on it):
45
+
46
+ ```sh-session
47
+ curl -fsSL https://aoox.dev/install-cli.sh | sh
48
+ ```
49
+
50
+ This installs to `/usr/local/lib/aoox` + `/usr/local/bin/aoox` when run as root or with
51
+ passwordless `sudo` available, or `~/.local/lib/aoox` + `~/.local/bin/aoox` otherwise (a `curl |
52
+ sh` pipe can't relay an interactive `sudo` password prompt safely, so the script never tries).
53
+ Re-running it upgrades in place. Supports Linux (glibc — not Alpine/musl) and macOS on x64/arm64;
54
+ anything else needs the npm install below instead. See the comment header of
55
+ [`install-cli.sh`](https://github.com/hideandseeklab/aoox-landing/blob/main/public/install-cli.sh)
56
+ for every environment variable it accepts (pinning a version, a custom install directory, etc).
57
+
58
+ ## npm (Windows, Alpine, or if you already have Node.js)
37
59
 
38
60
  ```sh-session
39
- npm install -g @hideandseeklab/aoox@alpha
61
+ npm install -g @hideandseeklab/aoox
40
62
  ```
41
63
 
64
+ While the project is in alpha every release is published under both the `latest` and `alpha` tags, so no tag is needed. To update later, run `aoox update` (`aoox update panel` updates the panel).
65
+
42
66
  `aoox` is then available globally. This also applies to `aoox install` on a new VPS —
43
67
  Node ≥22 must already be installed on that VPS **before** the step above (`aoox install`
44
- itself needs Node to run, so it cannot install Node for you first).
68
+ itself needs Node to run, so it cannot install Node for you first) — or use the install script
69
+ above, which needs no Node.js on the VPS at all.
70
+
71
+ ## From source
45
72
 
46
73
  To install from source (e.g. to contribute, or to get the latest `main` before it is
47
74
  released to npm):
@@ -58,6 +85,18 @@ npm link # or: npm install -g .
58
85
  <!-- commands -->
59
86
  * [`aoox deploy`](#aoox-deploy)
60
87
  * [`aoox domain set`](#aoox-domain-set)
88
+ * [`aoox env diff`](#aoox-env-diff)
89
+ * [`aoox env history`](#aoox-env-history)
90
+ * [`aoox env link`](#aoox-env-link)
91
+ * [`aoox env links`](#aoox-env-links)
92
+ * [`aoox env list`](#aoox-env-list)
93
+ * [`aoox env promote`](#aoox-env-promote)
94
+ * [`aoox env pull`](#aoox-env-pull)
95
+ * [`aoox env push`](#aoox-env-push)
96
+ * [`aoox env set ASSIGNMENTS`](#aoox-env-set-assignments)
97
+ * [`aoox env sets`](#aoox-env-sets)
98
+ * [`aoox env unlink`](#aoox-env-unlink)
99
+ * [`aoox env unset KEYS`](#aoox-env-unset-keys)
61
100
  * [`aoox help [COMMAND]`](#aoox-help-command)
62
101
  * [`aoox install`](#aoox-install)
63
102
  * [`aoox link`](#aoox-link)
@@ -72,13 +111,18 @@ npm link # or: npm install -g .
72
111
  * [`aoox plugins uninstall [PLUGIN]`](#aoox-plugins-uninstall-plugin)
73
112
  * [`aoox plugins unlink [PLUGIN]`](#aoox-plugins-unlink-plugin)
74
113
  * [`aoox plugins update`](#aoox-plugins-update)
114
+ * [`aoox registry build IMAGE`](#aoox-registry-build-image)
75
115
  * [`aoox registry domain`](#aoox-registry-domain)
116
+ * [`aoox registry push IMAGE`](#aoox-registry-push-image)
117
+ * [`aoox reinstall`](#aoox-reinstall)
118
+ * [`aoox run`](#aoox-run)
76
119
  * [`aoox update`](#aoox-update)
120
+ * [`aoox update panel`](#aoox-update-panel)
77
121
  * [`aoox whoami`](#aoox-whoami)
78
122
 
79
123
  ## `aoox deploy`
80
124
 
81
- Build image lokal, push ke registry aoox, lalu deploy (repo harus di-`aoox link` dulu)
125
+ Build a local image, push it to the aoox registry, then deploy (the repo must be linked with `aoox link` first)
82
126
 
83
127
  ```
84
128
  USAGE
@@ -86,15 +130,16 @@ USAGE
86
130
  <value>]
87
131
 
88
132
  FLAGS
89
- -f, --dockerfile=<value> [default: Dockerfile] Path ke Dockerfile
90
- -t, --token=<value> [env: AOOX_TOKEN] API token (aoox_…); default dari hasil `aoox login`
91
- -u, --url=<value> [env: AOOX_URL] URL panel aoox; default dari hasil `aoox login`
133
+ -f, --dockerfile=<value> [default: Dockerfile] Path to the Dockerfile
134
+ -t, --token=<value> [env: AOOX_TOKEN] API token (aoox_…); defaults to the value from `aoox login`
135
+ -u, --url=<value> [env: AOOX_URL] Dashboard URL (the address you open the dashboard with, e.g.
136
+ https://dashboard.example.com); defaults to the value from `aoox login`
92
137
  --context=<value> [default: .] Docker build context
93
- --registry=<value> ID registry tujuan push; default registry self-hosted
94
- --tag=<value> Tag image; default git short SHA (+ -dirty)
138
+ --registry=<value> Registry ID to push to; defaults to the self-hosted registry
139
+ --tag=<value> Image tag; defaults to the git short SHA (+ -dirty)
95
140
 
96
141
  DESCRIPTION
97
- Build image lokal, push ke registry aoox, lalu deploy (repo harus di-`aoox link` dulu)
142
+ Build a local image, push it to the aoox registry, then deploy (the repo must be linked with `aoox link` first)
98
143
 
99
144
  EXAMPLES
100
145
  $ aoox deploy
@@ -102,25 +147,26 @@ EXAMPLES
102
147
  $ aoox deploy --tag v1.2.3
103
148
  ```
104
149
 
105
- _See code: [src/commands/deploy.ts](https://github.com/hideandseeklab/aoox-cli/blob/v0.1.0-alpha.1/src/commands/deploy.ts)_
150
+ _See code: [src/commands/deploy.ts](https://github.com/hideandseeklab/aoox-cli/blob/v0.1.0-alpha.11/src/commands/deploy.ts)_
106
151
 
107
152
  ## `aoox domain set`
108
153
 
109
- Set domain kustom untuk panel itu sendiri (bukan aplikasi) lewat API panel yang sudah jalan
154
+ Set a custom domain for the panel itself (not an application) through the running panel API
110
155
 
111
156
  ```
112
157
  USAGE
113
158
  $ aoox domain set --api <value> --web <value> [-t <value>] [-u <value>] [--acme-email <value>]
114
159
 
115
160
  FLAGS
116
- -t, --token=<value> [env: AOOX_TOKEN] API token (aoox_…); default dari hasil `aoox login`
117
- -u, --url=<value> [env: AOOX_URL] URL panel aoox; default dari hasil `aoox login`
118
- --acme-email=<value> Email untuk sertifikat Let's Encrypt
119
- --api=<value> (required) Domain untuk API panel
120
- --web=<value> (required) Domain untuk dashboard panel
161
+ -t, --token=<value> [env: AOOX_TOKEN] API token (aoox_…); defaults to the value from `aoox login`
162
+ -u, --url=<value> [env: AOOX_URL] Dashboard URL (the address you open the dashboard with, e.g.
163
+ https://dashboard.example.com); defaults to the value from `aoox login`
164
+ --acme-email=<value> Email for the Let's Encrypt certificate
165
+ --api=<value> (required) Domain for the panel API
166
+ --web=<value> (required) Domain for the panel dashboard
121
167
 
122
168
  DESCRIPTION
123
- Set domain kustom untuk panel itu sendiri (bukan aplikasi) lewat API panel yang sudah jalan
169
+ Set a custom domain for the panel itself (not an application) through the running panel API
124
170
 
125
171
  EXAMPLES
126
172
  $ aoox domain set --web panel.example.com --api api.example.com
@@ -128,7 +174,442 @@ EXAMPLES
128
174
  $ aoox domain set --web panel.example.com --api api.example.com --acme-email you@example.com
129
175
  ```
130
176
 
131
- _See code: [src/commands/domain/set.ts](https://github.com/hideandseeklab/aoox-cli/blob/v0.1.0-alpha.1/src/commands/domain/set.ts)_
177
+ _See code: [src/commands/domain/set.ts](https://github.com/hideandseeklab/aoox-cli/blob/v0.1.0-alpha.11/src/commands/domain/set.ts)_
178
+
179
+ ## `aoox env diff`
180
+
181
+ Compare two environments of a variable set key by key: which variables exist on one side only and which have different values. Prints names only, never values
182
+
183
+ ```
184
+ USAGE
185
+ $ aoox env diff --from <value> --to <value> [--json] [-t <value>] [-u <value>] [--stack <value> | --app
186
+ <value>] [-s <value>]
187
+
188
+ FLAGS
189
+ -s, --set=<value> Variable set slug (or name). Default: the only set the linked application links, or the only set
190
+ you can see
191
+ -t, --token=<value> [env: AOOX_TOKEN] API token (aoox_…); defaults to the value from `aoox login`
192
+ -u, --url=<value> [env: AOOX_URL] Dashboard URL (the address you open the dashboard with, e.g.
193
+ https://dashboard.example.com); defaults to the value from `aoox login`
194
+ --app=<value> Application ID; defaults to the application linked with `aoox link`
195
+ --from=<value> (required) Environment to compare from
196
+ --stack=<value> Compose stack ID, instead of an application
197
+ --to=<value> (required) Environment to compare to
198
+
199
+ GLOBAL FLAGS
200
+ --json Format output as json.
201
+
202
+ DESCRIPTION
203
+ Compare two environments of a variable set key by key: which variables exist on one side only and which have different
204
+ values. Prints names only, never values
205
+
206
+ EXAMPLES
207
+ $ aoox env diff --set shared --from staging --to production
208
+ ```
209
+
210
+ _See code: [src/commands/env/diff.ts](https://github.com/hideandseeklab/aoox-cli/blob/v0.1.0-alpha.11/src/commands/env/diff.ts)_
211
+
212
+ ## `aoox env history`
213
+
214
+ Show the version history of a variable set environment: when, who, and which variable names were added (+), changed (~) or removed (-). Values are never shown
215
+
216
+ ```
217
+ USAGE
218
+ $ aoox env history [--json] [-t <value>] [-u <value>] [--stack <value> | --app <value>] [-e <value>] [-s
219
+ <value>] [--limit <value>]
220
+
221
+ FLAGS
222
+ -e, --env=<value> Environment of the set (e.g. development, staging, production). Default: the only environment of
223
+ the set the linked application links
224
+ -s, --set=<value> Variable set slug (or name). Default: the only set the linked application links, or the only set
225
+ you can see
226
+ -t, --token=<value> [env: AOOX_TOKEN] API token (aoox_…); defaults to the value from `aoox login`
227
+ -u, --url=<value> [env: AOOX_URL] Dashboard URL (the address you open the dashboard with, e.g.
228
+ https://dashboard.example.com); defaults to the value from `aoox login`
229
+ --app=<value> Application ID; defaults to the application linked with `aoox link`
230
+ --limit=<value> [default: 20] How many versions to show (newest first)
231
+ --stack=<value> Compose stack ID, instead of an application
232
+
233
+ GLOBAL FLAGS
234
+ --json Format output as json.
235
+
236
+ DESCRIPTION
237
+ Show the version history of a variable set environment: when, who, and which variable names were added (+), changed
238
+ (~) or removed (-). Values are never shown
239
+
240
+ EXAMPLES
241
+ $ aoox env history --set shared --env production
242
+
243
+ $ aoox env history --limit 5 --json
244
+ ```
245
+
246
+ _See code: [src/commands/env/history.ts](https://github.com/hideandseeklab/aoox-cli/blob/v0.1.0-alpha.11/src/commands/env/history.ts)_
247
+
248
+ ## `aoox env link`
249
+
250
+ Link a variable set environment to the linked application (or --stack). It is added last, so it wins over the other links, unless --position is given; an environment that is already linked is moved. Takes effect on the next deploy
251
+
252
+ ```
253
+ USAGE
254
+ $ aoox env link -e <value> -s <value> [--json] [-t <value>] [-u <value>] [--stack <value> | --app <value>]
255
+ [--position <value>]
256
+
257
+ FLAGS
258
+ -e, --env=<value> (required) Environment of the set
259
+ -s, --set=<value> (required) Variable set slug (or name)
260
+ -t, --token=<value> [env: AOOX_TOKEN] API token (aoox_…); defaults to the value from `aoox login`
261
+ -u, --url=<value> [env: AOOX_URL] Dashboard URL (the address you open the dashboard with, e.g.
262
+ https://dashboard.example.com); defaults to the value from `aoox login`
263
+ --app=<value> Application ID; defaults to the application linked with `aoox link`
264
+ --position=<value> 1-based place in the list (1 = first, overridden by every later link). Default: last
265
+ --stack=<value> Compose stack ID, instead of an application
266
+
267
+ GLOBAL FLAGS
268
+ --json Format output as json.
269
+
270
+ DESCRIPTION
271
+ Link a variable set environment to the linked application (or --stack). It is added last, so it wins over the other
272
+ links, unless --position is given; an environment that is already linked is moved. Takes effect on the next deploy
273
+
274
+ EXAMPLES
275
+ $ aoox env link --set shared --env production
276
+
277
+ $ aoox env link --set defaults --env production --position 1
278
+ ```
279
+
280
+ _See code: [src/commands/env/link.ts](https://github.com/hideandseeklab/aoox-cli/blob/v0.1.0-alpha.11/src/commands/env/link.ts)_
281
+
282
+ ## `aoox env links`
283
+
284
+ Show the variable set environments the linked application (or --stack) uses, in merge order, with the variables a later link or the own env overrides
285
+
286
+ ```
287
+ USAGE
288
+ $ aoox env links [--json] [-t <value>] [-u <value>] [--stack <value> | --app <value>]
289
+
290
+ FLAGS
291
+ -t, --token=<value> [env: AOOX_TOKEN] API token (aoox_…); defaults to the value from `aoox login`
292
+ -u, --url=<value> [env: AOOX_URL] Dashboard URL (the address you open the dashboard with, e.g.
293
+ https://dashboard.example.com); defaults to the value from `aoox login`
294
+ --app=<value> Application ID; defaults to the application linked with `aoox link`
295
+ --stack=<value> Compose stack ID, instead of an application
296
+
297
+ GLOBAL FLAGS
298
+ --json Format output as json.
299
+
300
+ DESCRIPTION
301
+ Show the variable set environments the linked application (or --stack) uses, in merge order, with the variables a
302
+ later link or the own env overrides
303
+
304
+ EXAMPLES
305
+ $ aoox env links
306
+
307
+ $ aoox env links --stack <id>
308
+ ```
309
+
310
+ _See code: [src/commands/env/links.ts](https://github.com/hideandseeklab/aoox-cli/blob/v0.1.0-alpha.11/src/commands/env/links.ts)_
311
+
312
+ ## `aoox env list`
313
+
314
+ List the variable sets you can see and their environments (with --set: one set; with --env: the variable names of one environment). Values are masked unless --reveal is given
315
+
316
+ ```
317
+ USAGE
318
+ $ aoox env list [--json] [-t <value>] [-u <value>] [--stack <value> | --app <value>] [-e <value>] [--reveal]
319
+ [-s <value>]
320
+
321
+ FLAGS
322
+ -e, --env=<value> Environment name; lists its variable names (the set defaults like in the other env commands)
323
+ -s, --set=<value> Variable set slug (or name). Default: the only set the linked application links, or the only set
324
+ you can see
325
+ -t, --token=<value> [env: AOOX_TOKEN] API token (aoox_…); defaults to the value from `aoox login`
326
+ -u, --url=<value> [env: AOOX_URL] Dashboard URL (the address you open the dashboard with, e.g.
327
+ https://dashboard.example.com); defaults to the value from `aoox login`
328
+ --app=<value> Application ID; defaults to the application linked with `aoox link`
329
+ --reveal Show the values (needs --env; the read is recorded in the audit log)
330
+ --stack=<value> Compose stack ID, instead of an application
331
+
332
+ GLOBAL FLAGS
333
+ --json Format output as json.
334
+
335
+ DESCRIPTION
336
+ List the variable sets you can see and their environments (with --set: one set; with --env: the variable names of one
337
+ environment). Values are masked unless --reveal is given
338
+
339
+ ALIASES
340
+ $ aoox env sets
341
+
342
+ EXAMPLES
343
+ $ aoox env list
344
+
345
+ $ aoox env list --set shared
346
+
347
+ $ aoox env list --set shared --env staging
348
+
349
+ $ aoox env list --set shared --env development --reveal
350
+ ```
351
+
352
+ _See code: [src/commands/env/list.ts](https://github.com/hideandseeklab/aoox-cli/blob/v0.1.0-alpha.11/src/commands/env/list.ts)_
353
+
354
+ ## `aoox env promote`
355
+
356
+ Copy variables (and their secret flag) from one environment of a variable set to another (name them, or use --all). Needs the right to read the source and to change the target. The target keeps its comments and order; new variables are appended. Shows what changes and asks before writing (unless --yes)
357
+
358
+ ```
359
+ USAGE
360
+ $ aoox env promote --from <value> --to <value> [-t <value>] [-u <value>] [--stack <value> | --app <value>]
361
+ [--all] [-s <value>] [-y]
362
+
363
+ FLAGS
364
+ -s, --set=<value> Variable set slug (or name). Default: the only set the linked application links, or the only set
365
+ you can see
366
+ -t, --token=<value> [env: AOOX_TOKEN] API token (aoox_…); defaults to the value from `aoox login`
367
+ -u, --url=<value> [env: AOOX_URL] Dashboard URL (the address you open the dashboard with, e.g.
368
+ https://dashboard.example.com); defaults to the value from `aoox login`
369
+ -y, --yes Do not ask for confirmation
370
+ --all Promote every variable of the source (those already equal are skipped)
371
+ --app=<value> Application ID; defaults to the application linked with `aoox link`
372
+ --from=<value> (required) Environment to copy the values from
373
+ --stack=<value> Compose stack ID, instead of an application
374
+ --to=<value> (required) Environment to copy the values into
375
+
376
+ DESCRIPTION
377
+ Copy variables (and their secret flag) from one environment of a variable set to another (name them, or use --all).
378
+ Needs the right to read the source and to change the target. The target keeps its comments and order; new variables
379
+ are appended. Shows what changes and asks before writing (unless --yes)
380
+
381
+ EXAMPLES
382
+ $ aoox env promote --set shared --from staging --to production API_URL FEATURE_X
383
+
384
+ $ aoox env promote --from development --to staging --all --yes
385
+ ```
386
+
387
+ _See code: [src/commands/env/promote.ts](https://github.com/hideandseeklab/aoox-cli/blob/v0.1.0-alpha.11/src/commands/env/promote.ts)_
388
+
389
+ ## `aoox env pull`
390
+
391
+ Write the variables of a variable set environment to a local file (mode 0600), or to standard output with --file -. Refuses to overwrite unless --force. The read is recorded in the audit log
392
+
393
+ ```
394
+ USAGE
395
+ $ aoox env pull [-t <value>] [-u <value>] [--stack <value> | --app <value>] [-e <value>] [-s <value>]
396
+ [--file <value>] [--force] [--format dotenv|json|shell]
397
+
398
+ FLAGS
399
+ -e, --env=<value> Environment of the set (e.g. development, staging, production). Default: the only environment
400
+ of the set the linked application links
401
+ -s, --set=<value> Variable set slug (or name). Default: the only set the linked application links, or the only
402
+ set you can see
403
+ -t, --token=<value> [env: AOOX_TOKEN] API token (aoox_…); defaults to the value from `aoox login`
404
+ -u, --url=<value> [env: AOOX_URL] Dashboard URL (the address you open the dashboard with, e.g.
405
+ https://dashboard.example.com); defaults to the value from `aoox login`
406
+ --app=<value> Application ID; defaults to the application linked with `aoox link`
407
+ --file=<value> File to write, relative to the current folder; "-" writes to standard output (nothing else is
408
+ printed there). Default: .env, .env.json or .env.sh by format
409
+ --force Overwrite the file if it exists
410
+ --format=<option> [default: dotenv] dotenv (the stored text, comments kept), json ({"KEY":"value"}) or shell
411
+ (export KEY='value' lines for eval)
412
+ <options: dotenv|json|shell>
413
+ --stack=<value> Compose stack ID, instead of an application
414
+
415
+ DESCRIPTION
416
+ Write the variables of a variable set environment to a local file (mode 0600), or to standard output with --file -.
417
+ Refuses to overwrite unless --force. The read is recorded in the audit log
418
+
419
+ EXAMPLES
420
+ $ aoox env pull
421
+
422
+ $ aoox env pull --set shared --env staging --file .env.staging
423
+
424
+ $ aoox env pull --force
425
+
426
+ $ aoox env pull --format json --file -
427
+
428
+ $ aoox env pull --format shell --file -
429
+ ```
430
+
431
+ _See code: [src/commands/env/pull.ts](https://github.com/hideandseeklab/aoox-cli/blob/v0.1.0-alpha.11/src/commands/env/pull.ts)_
432
+
433
+ ## `aoox env push`
434
+
435
+ Replace the whole text of a variable set environment with a local .env file. Shows what is added, changed and removed and asks before writing (unless --yes); the write fails if someone else changed the environment in between
436
+
437
+ ```
438
+ USAGE
439
+ $ aoox env push --file <value> [-t <value>] [-u <value>] [--stack <value> | --app <value>] [-e <value>] [-s
440
+ <value>] [-y]
441
+
442
+ FLAGS
443
+ -e, --env=<value> Environment of the set (e.g. development, staging, production). Default: the only environment of
444
+ the set the linked application links
445
+ -s, --set=<value> Variable set slug (or name). Default: the only set the linked application links, or the only set
446
+ you can see
447
+ -t, --token=<value> [env: AOOX_TOKEN] API token (aoox_…); defaults to the value from `aoox login`
448
+ -u, --url=<value> [env: AOOX_URL] Dashboard URL (the address you open the dashboard with, e.g.
449
+ https://dashboard.example.com); defaults to the value from `aoox login`
450
+ -y, --yes Do not ask for confirmation
451
+ --app=<value> Application ID; defaults to the application linked with `aoox link`
452
+ --file=<value> (required) The .env file to upload
453
+ --stack=<value> Compose stack ID, instead of an application
454
+
455
+ DESCRIPTION
456
+ Replace the whole text of a variable set environment with a local .env file. Shows what is added, changed and removed
457
+ and asks before writing (unless --yes); the write fails if someone else changed the environment in between
458
+
459
+ EXAMPLES
460
+ $ aoox env push --file .env
461
+
462
+ $ aoox env push --file .env.staging --set shared --env staging --yes
463
+ ```
464
+
465
+ _See code: [src/commands/env/push.ts](https://github.com/hideandseeklab/aoox-cli/blob/v0.1.0-alpha.11/src/commands/env/push.ts)_
466
+
467
+ ## `aoox env set ASSIGNMENTS`
468
+
469
+ Set one or more variables in a variable set environment. Existing comments and order are kept; the write fails if someone else changed the environment in between
470
+
471
+ ```
472
+ USAGE
473
+ $ aoox env set ASSIGNMENTS... [-t <value>] [-u <value>] [--stack <value> | --app <value>] [-e <value>] [-s
474
+ <value>] [--secret]
475
+
476
+ ARGUMENTS
477
+ ASSIGNMENTS... KEY=VALUE (the value is stored exactly as given)
478
+
479
+ FLAGS
480
+ -e, --env=<value> Environment of the set (e.g. development, staging, production). Default: the only environment of
481
+ the set the linked application links
482
+ -s, --set=<value> Variable set slug (or name). Default: the only set the linked application links, or the only set
483
+ you can see
484
+ -t, --token=<value> [env: AOOX_TOKEN] API token (aoox_…); defaults to the value from `aoox login`
485
+ -u, --url=<value> [env: AOOX_URL] Dashboard URL (the address you open the dashboard with, e.g.
486
+ https://dashboard.example.com); defaults to the value from `aoox login`
487
+ --app=<value> Application ID; defaults to the application linked with `aoox link`
488
+ --[no-]secret Mark the variables as secret (--secret: always masked in logs) or explicitly not secret
489
+ (--no-secret: never masked). Without either the flag is left as it is
490
+ --stack=<value> Compose stack ID, instead of an application
491
+
492
+ DESCRIPTION
493
+ Set one or more variables in a variable set environment. Existing comments and order are kept; the write fails if
494
+ someone else changed the environment in between
495
+
496
+ EXAMPLES
497
+ $ aoox env set API_URL=https://api.example.com --set shared --env production
498
+
499
+ $ aoox env set GREETING="hello world" QUERY=a=b --env staging
500
+
501
+ $ aoox env set API_TOKEN=abc123 --secret
502
+ ```
503
+
504
+ _See code: [src/commands/env/set.ts](https://github.com/hideandseeklab/aoox-cli/blob/v0.1.0-alpha.11/src/commands/env/set.ts)_
505
+
506
+ ## `aoox env sets`
507
+
508
+ List the variable sets you can see and their environments (with --set: one set; with --env: the variable names of one environment). Values are masked unless --reveal is given
509
+
510
+ ```
511
+ USAGE
512
+ $ aoox env sets [--json] [-t <value>] [-u <value>] [--stack <value> | --app <value>] [-e <value>] [--reveal]
513
+ [-s <value>]
514
+
515
+ FLAGS
516
+ -e, --env=<value> Environment name; lists its variable names (the set defaults like in the other env commands)
517
+ -s, --set=<value> Variable set slug (or name). Default: the only set the linked application links, or the only set
518
+ you can see
519
+ -t, --token=<value> [env: AOOX_TOKEN] API token (aoox_…); defaults to the value from `aoox login`
520
+ -u, --url=<value> [env: AOOX_URL] Dashboard URL (the address you open the dashboard with, e.g.
521
+ https://dashboard.example.com); defaults to the value from `aoox login`
522
+ --app=<value> Application ID; defaults to the application linked with `aoox link`
523
+ --reveal Show the values (needs --env; the read is recorded in the audit log)
524
+ --stack=<value> Compose stack ID, instead of an application
525
+
526
+ GLOBAL FLAGS
527
+ --json Format output as json.
528
+
529
+ DESCRIPTION
530
+ List the variable sets you can see and their environments (with --set: one set; with --env: the variable names of one
531
+ environment). Values are masked unless --reveal is given
532
+
533
+ ALIASES
534
+ $ aoox env sets
535
+
536
+ EXAMPLES
537
+ $ aoox env sets
538
+
539
+ $ aoox env sets --set shared
540
+
541
+ $ aoox env sets --set shared --env staging
542
+
543
+ $ aoox env sets --set shared --env development --reveal
544
+ ```
545
+
546
+ ## `aoox env unlink`
547
+
548
+ Remove a variable set environment from the linked application (or --stack). Name it with --set and --env, or with its --position from `aoox env links`. Takes effect on the next deploy
549
+
550
+ ```
551
+ USAGE
552
+ $ aoox env unlink [--json] [-t <value>] [-u <value>] [--stack <value> | --app <value>] [--position <value> |
553
+ -s <value> | -e <value>]
554
+
555
+ FLAGS
556
+ -e, --env=<value> Environment of the set
557
+ -s, --set=<value> Variable set slug (or name)
558
+ -t, --token=<value> [env: AOOX_TOKEN] API token (aoox_…); defaults to the value from `aoox login`
559
+ -u, --url=<value> [env: AOOX_URL] Dashboard URL (the address you open the dashboard with, e.g.
560
+ https://dashboard.example.com); defaults to the value from `aoox login`
561
+ --app=<value> Application ID; defaults to the application linked with `aoox link`
562
+ --position=<value> 1-based position as shown by `aoox env links`
563
+ --stack=<value> Compose stack ID, instead of an application
564
+
565
+ GLOBAL FLAGS
566
+ --json Format output as json.
567
+
568
+ DESCRIPTION
569
+ Remove a variable set environment from the linked application (or --stack). Name it with --set and --env, or with its
570
+ --position from `aoox env links`. Takes effect on the next deploy
571
+
572
+ EXAMPLES
573
+ $ aoox env unlink --set shared --env staging
574
+
575
+ $ aoox env unlink --position 2
576
+ ```
577
+
578
+ _See code: [src/commands/env/unlink.ts](https://github.com/hideandseeklab/aoox-cli/blob/v0.1.0-alpha.11/src/commands/env/unlink.ts)_
579
+
580
+ ## `aoox env unset KEYS`
581
+
582
+ Remove one or more variables from a variable set environment. Comments and the other variables are kept; the write fails if someone else changed the environment in between
583
+
584
+ ```
585
+ USAGE
586
+ $ aoox env unset KEYS... [-t <value>] [-u <value>] [--stack <value> | --app <value>] [-e <value>] [-s <value>]
587
+
588
+ ARGUMENTS
589
+ KEYS... Variable name(s) to remove
590
+
591
+ FLAGS
592
+ -e, --env=<value> Environment of the set (e.g. development, staging, production). Default: the only environment of
593
+ the set the linked application links
594
+ -s, --set=<value> Variable set slug (or name). Default: the only set the linked application links, or the only set
595
+ you can see
596
+ -t, --token=<value> [env: AOOX_TOKEN] API token (aoox_…); defaults to the value from `aoox login`
597
+ -u, --url=<value> [env: AOOX_URL] Dashboard URL (the address you open the dashboard with, e.g.
598
+ https://dashboard.example.com); defaults to the value from `aoox login`
599
+ --app=<value> Application ID; defaults to the application linked with `aoox link`
600
+ --stack=<value> Compose stack ID, instead of an application
601
+
602
+ DESCRIPTION
603
+ Remove one or more variables from a variable set environment. Comments and the other variables are kept; the write
604
+ fails if someone else changed the environment in between
605
+
606
+ EXAMPLES
607
+ $ aoox env unset OLD_KEY
608
+
609
+ $ aoox env unset A B --set shared --env staging
610
+ ```
611
+
612
+ _See code: [src/commands/env/unset.ts](https://github.com/hideandseeklab/aoox-cli/blob/v0.1.0-alpha.11/src/commands/env/unset.ts)_
132
613
 
133
614
  ## `aoox help [COMMAND]`
134
615
 
@@ -152,26 +633,31 @@ _See code: [@oclif/plugin-help](https://github.com/oclif/plugin-help/blob/6.3.0/
152
633
 
153
634
  ## `aoox install`
154
635
 
155
- Pasang aoox (postgres + api + web) di VPS baru lewat Docker Compose
636
+ Install aoox (postgres + api + web) on a fresh VPS with Docker Compose
156
637
 
157
638
  ```
158
639
  USAGE
159
640
  $ aoox install [--acme-email <value>] [--admin-name <value> --admin-email <value>] [--admin-password
160
- <value> ] [--api-domain <value> --web-domain <value>] [--dir <value>] [--force] [-y]
641
+ <value> ] [--api-domain <value> --web-domain <value>] [--dir <value>] [--force] [--no-terminal-authorize]
642
+ [--terminal-ssh-user <value>] [-y]
161
643
 
162
644
  FLAGS
163
- -y, --yes Jangan tanya konfirmasi apa pun
164
- --acme-email=<value> Wajib bersama --web-domain/--api-domain (Let’s Encrypt)
165
- --admin-email=<value> Buat owner pertama tanpa lewat /setup di browser
166
- --admin-name=<value> Nama owner pertama
167
- --admin-password=<value> Password owner pertama (min. 8 karakter)
168
- --api-domain=<value> Domain untuk API, lewat proxy bawaan
169
- --dir=<value> [default: /opt/aoox] Folder instalasi
170
- --force Timpa instalasi yang sudah ada di --dir
171
- --web-domain=<value> Domain untuk panel web, lewat proxy bawaan
645
+ -y, --yes Do not ask for any confirmation
646
+ --acme-email=<value> Required with --web-domain/--api-domain (Let’s Encrypt)
647
+ --admin-email=<value> Create the first owner without going through /setup in the browser
648
+ --admin-name=<value> Name of the first owner
649
+ --admin-password=<value> Password of the first owner (min. 8 characters)
650
+ --api-domain=<value> Domain for the API, served through the bundled proxy
651
+ --dir=<value> [default: /opt/aoox] Installation directory
652
+ --force Overwrite an existing installation in --dir
653
+ --no-terminal-authorize Do not create/authorize the web Terminal SSH key automatically (do it in Settings >
654
+ Terminal instead)
655
+ --terminal-ssh-user=<value> SSH user the web Terminal uses to log in to this host (default: the user running
656
+ sudo, or root if there is none)
657
+ --web-domain=<value> Domain for the web panel, served through the bundled proxy
172
658
 
173
659
  DESCRIPTION
174
- Pasang aoox (postgres + api + web) di VPS baru lewat Docker Compose
660
+ Install aoox (postgres + api + web) on a fresh VPS with Docker Compose
175
661
 
176
662
  EXAMPLES
177
663
  sudo aoox install
@@ -179,24 +665,26 @@ EXAMPLES
179
665
  sudo aoox install --web-domain panel.example.com --api-domain api.panel.example.com --acme-email me@example.com
180
666
  ```
181
667
 
182
- _See code: [src/commands/install.ts](https://github.com/hideandseeklab/aoox-cli/blob/v0.1.0-alpha.1/src/commands/install.ts)_
668
+ _See code: [src/commands/install.ts](https://github.com/hideandseeklab/aoox-cli/blob/v0.1.0-alpha.11/src/commands/install.ts)_
183
669
 
184
670
  ## `aoox link`
185
671
 
186
- Hubungkan folder ini ke sebuah aplikasi di panel (dipakai `aoox deploy`/`aoox logs`)
672
+ Link this folder to an application in the panel (used by `aoox deploy`, `aoox run` without `--set`/`--env`, and the `aoox env` defaults and links)
187
673
 
188
674
  ```
189
675
  USAGE
190
676
  $ aoox link [-t <value>] [-u <value>] [--app <value>] [--project <value>]
191
677
 
192
678
  FLAGS
193
- -t, --token=<value> [env: AOOX_TOKEN] API token (aoox_…); default dari hasil `aoox login`
194
- -u, --url=<value> [env: AOOX_URL] URL panel aoox; default dari hasil `aoox login`
195
- --app=<value> ID aplikasi; lewati pemilihan interaktif
196
- --project=<value> ID project; lewati pemilihan interaktif
679
+ -t, --token=<value> [env: AOOX_TOKEN] API token (aoox_…); defaults to the value from `aoox login`
680
+ -u, --url=<value> [env: AOOX_URL] Dashboard URL (the address you open the dashboard with, e.g.
681
+ https://dashboard.example.com); defaults to the value from `aoox login`
682
+ --app=<value> Application ID; skip the interactive selection
683
+ --project=<value> Project ID; skip the interactive selection
197
684
 
198
685
  DESCRIPTION
199
- Hubungkan folder ini ke sebuah aplikasi di panel (dipakai `aoox deploy`/`aoox logs`)
686
+ Link this folder to an application in the panel (used by `aoox deploy`, `aoox run` without `--set`/`--env`, and the
687
+ `aoox env` defaults and links)
200
688
 
201
689
  EXAMPLES
202
690
  $ aoox link
@@ -204,30 +692,33 @@ EXAMPLES
204
692
  $ aoox link --project <id> --app <id>
205
693
  ```
206
694
 
207
- _See code: [src/commands/link.ts](https://github.com/hideandseeklab/aoox-cli/blob/v0.1.0-alpha.1/src/commands/link.ts)_
695
+ _See code: [src/commands/link.ts](https://github.com/hideandseeklab/aoox-cli/blob/v0.1.0-alpha.11/src/commands/link.ts)_
208
696
 
209
697
  ## `aoox login`
210
698
 
211
- Simpan URL panel dan API token untuk perintah lain
699
+ Save the dashboard address and API token for other commands (the API address is discovered automatically)
212
700
 
213
701
  ```
214
702
  USAGE
215
703
  $ aoox login [-t <value>] [-u <value>]
216
704
 
217
705
  FLAGS
218
- -t, --token=<value> [env: AOOX_TOKEN] API token (aoox_…); default dari hasil `aoox login`
219
- -u, --url=<value> [env: AOOX_URL] URL panel aoox; default dari hasil `aoox login`
706
+ -t, --token=<value> [env: AOOX_TOKEN] API token (aoox_…); defaults to the value from `aoox login`
707
+ -u, --url=<value> [env: AOOX_URL] Dashboard URL (the address you open the dashboard with, e.g.
708
+ https://dashboard.example.com); defaults to the value from `aoox login`
220
709
 
221
710
  DESCRIPTION
222
- Simpan URL panel dan API token untuk perintah lain
711
+ Save the dashboard address and API token for other commands (the API address is discovered automatically)
223
712
 
224
713
  EXAMPLES
225
714
  $ aoox login
226
715
 
227
- $ aoox login --url https://panel.example.com --token aoox_xxx
716
+ $ aoox login --url https://dashboard.example.com --token aoox_xxx
717
+
718
+ $ aoox login --url 203.0.113.10:3000 --token aoox_xxx
228
719
  ```
229
720
 
230
- _See code: [src/commands/login.ts](https://github.com/hideandseeklab/aoox-cli/blob/v0.1.0-alpha.1/src/commands/login.ts)_
721
+ _See code: [src/commands/login.ts](https://github.com/hideandseeklab/aoox-cli/blob/v0.1.0-alpha.11/src/commands/login.ts)_
231
722
 
232
723
  ## `aoox plugins`
233
724
 
@@ -519,22 +1010,60 @@ DESCRIPTION
519
1010
 
520
1011
  _See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/5.5.2/src/commands/plugins/update.ts)_
521
1012
 
1013
+ ## `aoox registry build IMAGE`
1014
+
1015
+ Build an image from a Dockerfile, named for the aoox registry (refuses a version that already exists there)
1016
+
1017
+ ```
1018
+ USAGE
1019
+ $ aoox registry build IMAGE [-t <value>] [-u <value>] [--force] [--registry <value>] [--context <value>] [-f
1020
+ <value>] [--push]
1021
+
1022
+ ARGUMENTS
1023
+ IMAGE Image name and version, e.g. myapp:1.0.0
1024
+
1025
+ FLAGS
1026
+ -f, --dockerfile=<value> [default: Dockerfile] Path to the Dockerfile
1027
+ -t, --token=<value> [env: AOOX_TOKEN] API token (aoox_…); defaults to the value from `aoox login`
1028
+ -u, --url=<value> [env: AOOX_URL] Dashboard URL (the address you open the dashboard with, e.g.
1029
+ https://dashboard.example.com); defaults to the value from `aoox login`
1030
+ --context=<value> [default: .] Docker build context
1031
+ --force Overwrite a version that already exists in the registry
1032
+ --push Push the image to the registry right after the build
1033
+ --registry=<value> Registry ID; defaults to the self-hosted registry
1034
+
1035
+ DESCRIPTION
1036
+ Build an image from a Dockerfile, named for the aoox registry (refuses a version that already exists there)
1037
+
1038
+ EXAMPLES
1039
+ $ aoox registry build myapp:1.0.0
1040
+
1041
+ $ aoox registry build myapp:1.0.0 --push
1042
+
1043
+ $ aoox registry build team/api:2.1.0 -f docker/Dockerfile --context .
1044
+
1045
+ $ aoox registry build myapp:1.0.0 --force
1046
+ ```
1047
+
1048
+ _See code: [src/commands/registry/build.ts](https://github.com/hideandseeklab/aoox-cli/blob/v0.1.0-alpha.11/src/commands/registry/build.ts)_
1049
+
522
1050
  ## `aoox registry domain`
523
1051
 
524
- Set atau hapus domain kustom untuk registry self-hosted
1052
+ Set or remove the custom domain for the self-hosted registry
525
1053
 
526
1054
  ```
527
1055
  USAGE
528
1056
  $ aoox registry domain [-t <value>] [-u <value>] [--clear] [--set <value>]
529
1057
 
530
1058
  FLAGS
531
- -t, --token=<value> [env: AOOX_TOKEN] API token (aoox_…); default dari hasil `aoox login`
532
- -u, --url=<value> [env: AOOX_URL] URL panel aoox; default dari hasil `aoox login`
533
- --clear Hapus domain, kembali ke host:port
534
- --set=<value> Domain untuk registry self-hosted
1059
+ -t, --token=<value> [env: AOOX_TOKEN] API token (aoox_…); defaults to the value from `aoox login`
1060
+ -u, --url=<value> [env: AOOX_URL] Dashboard URL (the address you open the dashboard with, e.g.
1061
+ https://dashboard.example.com); defaults to the value from `aoox login`
1062
+ --clear Remove the domain, falling back to host:port
1063
+ --set=<value> Domain for the self-hosted registry
535
1064
 
536
1065
  DESCRIPTION
537
- Set atau hapus domain kustom untuk registry self-hosted
1066
+ Set or remove the custom domain for the self-hosted registry
538
1067
 
539
1068
  EXAMPLES
540
1069
  $ aoox registry domain --set registry.example.com
@@ -542,49 +1071,179 @@ EXAMPLES
542
1071
  $ aoox registry domain --clear
543
1072
  ```
544
1073
 
545
- _See code: [src/commands/registry/domain.ts](https://github.com/hideandseeklab/aoox-cli/blob/v0.1.0-alpha.1/src/commands/registry/domain.ts)_
1074
+ _See code: [src/commands/registry/domain.ts](https://github.com/hideandseeklab/aoox-cli/blob/v0.1.0-alpha.11/src/commands/registry/domain.ts)_
1075
+
1076
+ ## `aoox registry push IMAGE`
1077
+
1078
+ Push a local image to the aoox registry (refuses a version that already exists there)
1079
+
1080
+ ```
1081
+ USAGE
1082
+ $ aoox registry push IMAGE [-t <value>] [-u <value>] [--force] [--registry <value>]
1083
+
1084
+ ARGUMENTS
1085
+ IMAGE Image name and version (short or full), e.g. myapp:1.0.0
1086
+
1087
+ FLAGS
1088
+ -t, --token=<value> [env: AOOX_TOKEN] API token (aoox_…); defaults to the value from `aoox login`
1089
+ -u, --url=<value> [env: AOOX_URL] Dashboard URL (the address you open the dashboard with, e.g.
1090
+ https://dashboard.example.com); defaults to the value from `aoox login`
1091
+ --force Overwrite a version that already exists in the registry
1092
+ --registry=<value> Registry ID; defaults to the self-hosted registry
1093
+
1094
+ DESCRIPTION
1095
+ Push a local image to the aoox registry (refuses a version that already exists there)
1096
+
1097
+ EXAMPLES
1098
+ $ aoox registry push myapp:1.0.0
1099
+
1100
+ $ aoox registry push registry.example.com/myapp:1.0.0
1101
+
1102
+ $ aoox registry push myapp:1.0.0 --force
1103
+ ```
1104
+
1105
+ _See code: [src/commands/registry/push.ts](https://github.com/hideandseeklab/aoox-cli/blob/v0.1.0-alpha.11/src/commands/registry/push.ts)_
1106
+
1107
+ ## `aoox reinstall`
1108
+
1109
+ Repair/refresh an existing aoox installation without losing data: rewrite compose, merge .env.dist (secrets are never regenerated), then pull + recreate
1110
+
1111
+ ```
1112
+ USAGE
1113
+ $ aoox reinstall [--dir <value>] [--dry-run] [--no-pull] [--terminal-ssh-user <value>] [-y]
1114
+
1115
+ FLAGS
1116
+ -y, --yes Do not ask for confirmation
1117
+ --dir=<value> [default: /opt/aoox] Installation directory
1118
+ --dry-run Print the plan (changed files, keys to add, compose commands) without changing
1119
+ anything
1120
+ --no-pull Skip docker compose pull (use the images already present)
1121
+ --terminal-ssh-user=<value> Set/overwrite TERMINAL_SSH_USER in .env.dist during repair
1122
+
1123
+ DESCRIPTION
1124
+ Repair/refresh an existing aoox installation without losing data: rewrite compose, merge .env.dist (secrets are never
1125
+ regenerated), then pull + recreate
1126
+
1127
+ EXAMPLES
1128
+ sudo aoox reinstall --dry-run
1129
+
1130
+ sudo aoox reinstall
1131
+
1132
+ sudo aoox reinstall --yes --terminal-ssh-user root
1133
+ ```
1134
+
1135
+ _See code: [src/commands/reinstall.ts](https://github.com/hideandseeklab/aoox-cli/blob/v0.1.0-alpha.11/src/commands/reinstall.ts)_
1136
+
1137
+ ## `aoox run`
1138
+
1139
+ Run a command with the variables the linked application gets at deploy time, without writing them to disk: its linked variable set environments in order (a later one wins), then its own env on top. With --set/--env, exactly one set environment instead. Put the command after `--`; its exit code is forwarded. Before the command starts, one line on stderr says how many variables aoox injects and from which layers (colour only on a terminal; NO_COLOR turns it off, FORCE_COLOR forces it); --quiet hides it, but never the warnings. Every read is recorded in the audit log
1140
+
1141
+ ```
1142
+ USAGE
1143
+ $ aoox run [-t <value>] [-u <value>] [--stack <value> | --app <value>] [-e <value>] [-s <value>]
1144
+ [--file <value>] [-q]
1145
+
1146
+ FLAGS
1147
+ -e, --env=<value> Environment of the set (e.g. development, staging, production). Default: the only environment of
1148
+ the set the linked application links
1149
+ -q, --quiet Do not print the "Injecting N variables" line or the informational notes. Warnings about
1150
+ unresolved references and excluded Infisical secrets are always printed
1151
+ -s, --set=<value> Variable set slug (or name). Default: the only set the linked application links, or the only set
1152
+ you can see
1153
+ -t, --token=<value> [env: AOOX_TOKEN] API token (aoox_…); defaults to the value from `aoox login`
1154
+ -u, --url=<value> [env: AOOX_URL] Dashboard URL (the address you open the dashboard with, e.g.
1155
+ https://dashboard.example.com); defaults to the value from `aoox login`
1156
+ --app=<value> Application ID; defaults to the application linked with `aoox link`
1157
+ --file=<value> A local .env file layered on top (it wins over aoox, which wins over the current environment).
1158
+ Only read, never written
1159
+ --stack=<value> Compose stack ID, instead of an application
1160
+
1161
+ DESCRIPTION
1162
+ Run a command with the variables the linked application gets at deploy time, without writing them to disk: its linked
1163
+ variable set environments in order (a later one wins), then its own env on top. With --set/--env, exactly one set
1164
+ environment instead. Put the command after `--`; its exit code is forwarded. Before the command starts, one line on
1165
+ stderr says how many variables aoox injects and from which layers (colour only on a terminal; NO_COLOR turns it off,
1166
+ FORCE_COLOR forces it); --quiet hides it, but never the warnings. Every read is recorded in the audit log
1167
+
1168
+ EXAMPLES
1169
+ $ aoox run -- npm run dev
1170
+
1171
+ $ aoox run --set shared --env staging -- node server.js
1172
+
1173
+ $ aoox run --file .env.local -- npm run dev
1174
+
1175
+ $ aoox run --stack <id> -- docker compose config
1176
+
1177
+ $ aoox run --quiet -- npm run dev
1178
+ ```
1179
+
1180
+ _See code: [src/commands/run.ts](https://github.com/hideandseeklab/aoox-cli/blob/v0.1.0-alpha.11/src/commands/run.ts)_
546
1181
 
547
1182
  ## `aoox update`
548
1183
 
549
- Cek atau terapkan update untuk panel aoox itu sendiri
1184
+ Update the aoox CLI itself (use `aoox update panel` to update the panel)
550
1185
 
551
1186
  ```
552
1187
  USAGE
553
- $ aoox update [-t <value>] [-u <value>] [--apply]
1188
+ $ aoox update [--check]
554
1189
 
555
1190
  FLAGS
556
- -t, --token=<value> [env: AOOX_TOKEN] API token (aoox_…); default dari hasil `aoox login`
557
- -u, --url=<value> [env: AOOX_URL] URL panel aoox; default dari hasil `aoox login`
558
- --apply Terapkan update jika tersedia (pull + restart)
1191
+ --check Only report whether a newer version exists; change nothing
559
1192
 
560
1193
  DESCRIPTION
561
- Cek atau terapkan update untuk panel aoox itu sendiri
1194
+ Update the aoox CLI itself (use `aoox update panel` to update the panel)
562
1195
 
563
1196
  EXAMPLES
564
1197
  $ aoox update
565
1198
 
566
- $ aoox update --apply
1199
+ $ aoox update --check
1200
+ ```
1201
+
1202
+ _See code: [src/commands/update.ts](https://github.com/hideandseeklab/aoox-cli/blob/v0.1.0-alpha.11/src/commands/update.ts)_
1203
+
1204
+ ## `aoox update panel`
1205
+
1206
+ Check for or apply updates to the aoox panel itself (the aoox-api and aoox-web images)
1207
+
1208
+ ```
1209
+ USAGE
1210
+ $ aoox update panel [-t <value>] [-u <value>] [--apply]
1211
+
1212
+ FLAGS
1213
+ -t, --token=<value> [env: AOOX_TOKEN] API token (aoox_…); defaults to the value from `aoox login`
1214
+ -u, --url=<value> [env: AOOX_URL] Dashboard URL (the address you open the dashboard with, e.g.
1215
+ https://dashboard.example.com); defaults to the value from `aoox login`
1216
+ --apply Apply the update if one is available (pull + restart)
1217
+
1218
+ DESCRIPTION
1219
+ Check for or apply updates to the aoox panel itself (the aoox-api and aoox-web images)
1220
+
1221
+ EXAMPLES
1222
+ $ aoox update panel
1223
+
1224
+ $ aoox update panel --apply
567
1225
  ```
568
1226
 
569
- _See code: [src/commands/update.ts](https://github.com/hideandseeklab/aoox-cli/blob/v0.1.0-alpha.1/src/commands/update.ts)_
1227
+ _See code: [src/commands/update/panel.ts](https://github.com/hideandseeklab/aoox-cli/blob/v0.1.0-alpha.11/src/commands/update/panel.ts)_
570
1228
 
571
1229
  ## `aoox whoami`
572
1230
 
573
- Tampilkan akun dan panel yang sedang dipakai
1231
+ Show the account and panel in use
574
1232
 
575
1233
  ```
576
1234
  USAGE
577
1235
  $ aoox whoami [--json] [-t <value>] [-u <value>]
578
1236
 
579
1237
  FLAGS
580
- -t, --token=<value> [env: AOOX_TOKEN] API token (aoox_…); default dari hasil `aoox login`
581
- -u, --url=<value> [env: AOOX_URL] URL panel aoox; default dari hasil `aoox login`
1238
+ -t, --token=<value> [env: AOOX_TOKEN] API token (aoox_…); defaults to the value from `aoox login`
1239
+ -u, --url=<value> [env: AOOX_URL] Dashboard URL (the address you open the dashboard with, e.g.
1240
+ https://dashboard.example.com); defaults to the value from `aoox login`
582
1241
 
583
1242
  GLOBAL FLAGS
584
1243
  --json Format output as json.
585
1244
 
586
1245
  DESCRIPTION
587
- Tampilkan akun dan panel yang sedang dipakai
1246
+ Show the account and panel in use
588
1247
 
589
1248
  EXAMPLES
590
1249
  $ aoox whoami
@@ -592,7 +1251,7 @@ EXAMPLES
592
1251
  $ aoox whoami --json
593
1252
  ```
594
1253
 
595
- _See code: [src/commands/whoami.ts](https://github.com/hideandseeklab/aoox-cli/blob/v0.1.0-alpha.1/src/commands/whoami.ts)_
1254
+ _See code: [src/commands/whoami.ts](https://github.com/hideandseeklab/aoox-cli/blob/v0.1.0-alpha.11/src/commands/whoami.ts)_
596
1255
  <!-- commandsstop -->
597
1256
 
598
1257
  ## Versioning