You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: Docs/INSTALLATION.md
+42-42Lines changed: 42 additions & 42 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -160,140 +160,140 @@ LocalAuthentication is the macOS security mechanism. The visible prompt may offe
160
160
161
161
The script name is kept for compatibility with older acceptance scripts, but the default self-build runtime path uses an owner-only encrypted local file store gated by LocalAuthentication. It does not require shared Keychain access groups.
162
162
163
-
## Register hcloud Without cli.toml
163
+
## Register supabase Database Password
164
164
165
-
Do not use `hcloud context create` for the Agentic Secrets flow. That official hcloud mode stores the token in `~/.config/hcloud/cli.toml`.
165
+
Do not put the Supabase database password in `.env`, shell startup files, or tool-specific plaintext config for the Agentic Secrets flow.
166
166
167
-
Instead, register `hcloud` through Agentic Secrets and enter the token at the hidden prompt:
167
+
Instead, register `supabase` through Agentic Secrets and enter the database password at the hidden prompt:
The token is read by the broker-owned registration command and stored in the local encrypted secret store. Do not pass token values as command-line arguments.
176
+
The password is read by the broker-owned registration command and stored in the local encrypted secret store. Do not pass password values as command-line arguments.
177
177
178
178
For clipboard or automation use, pipe the value explicitly:
Run `hcloud` through Agentic Secrets with arguments after `--`:
186
+
Run `supabase` through Agentic Secrets with arguments after `--`:
187
187
188
188
```sh
189
-
"$PREFIX/bin/agentic-secrets" cli run hcloud -- server list
189
+
"$PREFIX/bin/agentic-secrets" cli run supabase -- db pull
190
190
```
191
191
192
-
Agentic Secrets prints its own diagnostics to stderr, requests local authentication before reading the secret, scrubs inherited secret-like environment variables, injects `HCLOUD_TOKEN` only into the child process, and leaves the target CLI stdout/stderr intact. Use `--quiet` before `--` when wrapping scripts:
192
+
Agentic Secrets prints its own diagnostics to stderr, requests local authentication before reading the secret, scrubs inherited secret-like environment variables, injects `SUPABASE_DB_PASSWORD` only into the child process, and leaves the target CLI stdout/stderr intact. Use `--quiet` before `--` when wrapping scripts:
193
193
194
194
```sh
195
-
"$PREFIX/bin/agentic-secrets" cli run hcloud --quiet -- server list
195
+
"$PREFIX/bin/agentic-secrets" cli run supabase --quiet -- db pull
196
196
```
197
197
198
198
After a successful prompt, Agentic Secrets writes a local authorization grant so repeated matching runs do not prompt every time. The default CLI authorization mode is `always`, which does not expire. `remember-24h`, `short`, and `once` are available per run. Grants store no secret value. Persistent grants are HMAC-signed with a device-local macOS Keychain key and bound to CLI name, target identity, workspace hash, config context, untrusted origin hint, provenance confidence, delivery mode, and secret alias. Short grants additionally bind action class, command digest, and risk. Each command is still policy-checked before secret delivery, and destructive commands require fresh approval.
199
199
200
200
Choose authorization mode for one run:
201
201
202
202
```sh
203
-
"$PREFIX/bin/agentic-secrets" cli run hcloud --authorization-mode remember-24h -- server list
204
-
"$PREFIX/bin/agentic-secrets" cli run hcloud --authorization-mode short --delivery-grant-ttl-seconds 60 -- server list
205
-
"$PREFIX/bin/agentic-secrets" cli run hcloud --authorization-mode once -- server list
203
+
"$PREFIX/bin/agentic-secrets" cli run supabase --authorization-mode remember-24h -- db pull
204
+
"$PREFIX/bin/agentic-secrets" cli run supabase --authorization-mode short --delivery-grant-ttl-seconds 60 -- db pull
205
+
"$PREFIX/bin/agentic-secrets" cli run supabase --authorization-mode once -- db pull
206
206
```
207
207
208
208
Legacy TTL override still selects short authorization mode:
209
209
210
210
```sh
211
-
"$PREFIX/bin/agentic-secrets" cli run hcloud --delivery-grant-ttl-seconds 0 -- server list
211
+
"$PREFIX/bin/agentic-secrets" cli run supabase --delivery-grant-ttl-seconds 0 -- db pull
212
212
```
213
213
214
214
Changing target identity, workspace, config context, origin hint, provenance confidence, delivery mode, or secret alias produces a different persistent authorization scope and requires a fresh local authentication prompt. For short grants, changing action class, command shape, or risk also requires a fresh prompt.
215
215
216
-
### Optional hcloud Shim
216
+
### Optional supabase Shim
217
217
218
-
If you want the normal `hcloud ...` command to route through Agentic Secrets, install an opt-in shim after registration:
218
+
If you want the normal `supabase ...` command to route through Agentic Secrets, install an opt-in shim after registration:
Open a new terminal or restart the tool runner so the shell picks up the shim PATH block, then verify command resolution. If Codex, Claude Code, or another agent app was already running during registration, restart that agent app before using `hcloud` from it.
224
+
Open a new terminal or restart the tool runner so the shell picks up the shim PATH block, then verify command resolution. If Codex, Claude Code, or another agent app was already running during registration, restart that agent app before using `supabase` from it.
225
225
226
226
```sh
227
-
command -v hcloud
228
-
hcloud version
227
+
command -v supabase
228
+
supabase version
229
229
```
230
230
231
-
Expected: `command -v hcloud` points under `~/Library/Application Support/AgenticSecrets/LocalInstall/shims/hcloud`.
231
+
Expected: `command -v supabase` points under `~/Library/Application Support/AgenticSecrets/LocalInstall/shims/supabase`.
232
232
233
-
The shim does not replace or modify the Homebrew binary. It is a symlink to the installed `agentic-secrets-shim` binary. The registered target remains the stable native CLI path, such as `/opt/homebrew/bin/hcloud`.
233
+
The shim does not replace or modify the Homebrew binary. It is a symlink to the installed `agentic-secrets-shim` binary. The registered target remains the stable native CLI path, such as `/opt/homebrew/bin/supabase`.
234
234
235
235
Normal commands are routed through the same broker-owned secret delivery path:
236
236
237
237
```sh
238
-
hcloud server list
238
+
supabase db pull
239
239
```
240
240
241
241
Global help/version commands pass through to the registered target without resolving or injecting secrets:
242
242
243
243
```sh
244
-
hcloud --help
245
-
hcloud server --help
246
-
hcloud version
244
+
supabase --help
245
+
supabase db --help
246
+
supabase version
247
247
```
248
248
249
249
The pass-through environment is scrubbed of inherited secret-like variables. This keeps basic inspection commands usable while avoiding token delivery for help/version output.
250
250
251
251
Pass-through help/version reads only non-secret registry metadata and intentionally avoids the registry Keychain integrity key so it does not prompt for local authentication just to show help or version output. Commands that can receive secrets still verify registry integrity in core before any secret-store read.
252
252
253
-
### Codex App hcloud Use
253
+
### Codex App supabase Use
254
254
255
255
Codex App may not inherit the same shell startup environment as Terminal. Avoid
256
-
putting provider tokens such as `HCLOUD_TOKEN` into `~/.codex/.env`; that would
257
-
move secret delivery back into Codex process environment. Instead, keep the token
256
+
putting provider secrets such as `SUPABASE_DB_PASSWORD` into `~/.codex/.env`; that would
257
+
move secret delivery back into Codex process environment. Instead, keep the password
258
258
registered in AgenticSecrets and install the per-CLI shim:
Then verify from inside Codex App or a Codex-spawned command:
265
265
266
266
```sh
267
-
command -v hcloud
268
-
hcloud server list
267
+
command -v supabase
268
+
supabase db pull
269
269
```
270
270
271
-
Expected: `command -v hcloud` resolves to
272
-
`~/Library/Application Support/AgenticSecrets/LocalInstall/shims/hcloud`, and
271
+
Expected: `command -v supabase` resolves to
272
+
`~/Library/Application Support/AgenticSecrets/LocalInstall/shims/supabase`, and
273
273
normal commands route through Agentic Secrets secret delivery.
274
274
275
275
Remove only the shim:
276
276
277
277
```sh
278
-
agentic-secrets cli shim uninstall hcloud
278
+
agentic-secrets cli shim uninstall supabase
279
279
```
280
280
281
-
Registration metadata and secret records remain intact until you run `agentic-secrets cli unregister hcloud --delete-secrets`.
281
+
Registration metadata and secret records remain intact until you run `agentic-secrets cli unregister supabase --delete-secrets`.
282
282
283
-
The default explicit flow does not require a separate `hcloud` shim symlink. The registration stores metadata in Agentic Secrets state and keeps the stable invocation path discovered from `PATH`, such as `/opt/homebrew/bin/hcloud`, plus the target binary identity captured at registration time. The registry JSON is paired with `cli-registry.integrity.json`, an HMAC-SHA256 integrity sidecar whose key is stored in the user's macOS Keychain with `WhenUnlockedThisDeviceOnly` accessibility. Hand-editing either file fails closed before Agentic Secrets asks for local authentication or resolves any secret.
283
+
The default explicit flow does not require a separate `supabase` shim symlink. The registration stores metadata in Agentic Secrets state and keeps the stable invocation path discovered from `PATH`, such as `/opt/homebrew/bin/supabase`, plus the target binary identity captured at registration time. The registry JSON is paired with `cli-registry.integrity.json`, an HMAC-SHA256 integrity sidecar whose key is stored in the user's macOS Keychain with `WhenUnlockedThisDeviceOnly` accessibility. Hand-editing either file fails closed before Agentic Secrets asks for local authentication or resolves any secret.
284
284
285
-
Each run validates the current target against the captured macOS designated requirement when available and otherwise falls back to SHA-256 identity pinning. Homebrew upgrades therefore fail closed until you verify the new binary and refresh target trust through Agentic Secrets; this does not require entering the token again, but it does require local authentication because it changes trusted CLI identity metadata:
285
+
Each run validates the current target against the captured macOS designated requirement when available and otherwise falls back to SHA-256 identity pinning. Homebrew upgrades therefore fail closed until you verify the new binary and refresh target trust through Agentic Secrets; this does not require entering the password again, but it does require local authentication because it changes trusted CLI identity metadata:
If the LocalAuthentication prompt is canceled or the target changes between the prompt and the registry write, the trust refresh fails closed and the existing registration remains unchanged. A manually registered versioned Cellar path is also pinned and must be trust-refreshed or registered again after that version is removed.
292
292
293
293
To remove the registration and its local secret record:
0 commit comments