From 8beab14f1e8e0eee02969165cc60d353b79a5bd1 Mon Sep 17 00:00:00 2001 From: David Karlsson <35727626+dvdksn@users.noreply.github.com> Date: Fri, 5 Jun 2026 14:11:32 +0200 Subject: [PATCH 1/3] sbx: mark set-custom as experimental (no longer hidden) Co-Authored-By: Claude Sonnet 4.6 --- content/manuals/ai/sandboxes/security/credentials.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/content/manuals/ai/sandboxes/security/credentials.md b/content/manuals/ai/sandboxes/security/credentials.md index 73a9ce6b8bce..eda4d9e96de3 100644 --- a/content/manuals/ai/sandboxes/security/credentials.md +++ b/content/manuals/ai/sandboxes/security/credentials.md @@ -173,9 +173,8 @@ network policy. For details, see ## Custom secrets > [!IMPORTANT] -> Custom secrets are experimental. The `set-custom` command is hidden -> from `sbx --help`, and behavior, flags, and the placeholder format may -> change. +> Custom secrets are experimental. Behavior, flags, and the placeholder format may +> change without notice. For credentials that don't fit the service-identifier model — for example, when an agent validates the environment variable format at boot, or when the From b8f89c0e554bce3fc96c59e8b739e0cbc84e86e8 Mon Sep 17 00:00:00 2001 From: David Karlsson <35727626+dvdksn@users.noreply.github.com> Date: Fri, 5 Jun 2026 14:14:46 +0200 Subject: [PATCH 2/3] sbx: remove "hidden" language for set-custom in build-an-agent Co-Authored-By: Claude Sonnet 4.6 --- content/manuals/ai/sandboxes/customize/build-an-agent.md | 6 ++---- 1 file changed, 2 insertions(+), 4 deletions(-) diff --git a/content/manuals/ai/sandboxes/customize/build-an-agent.md b/content/manuals/ai/sandboxes/customize/build-an-agent.md index a874385a4de0..86ca2a0e3e5b 100644 --- a/content/manuals/ai/sandboxes/customize/build-an-agent.md +++ b/content/manuals/ai/sandboxes/customize/build-an-agent.md @@ -249,8 +249,7 @@ outbound requests to `ampcode.com`. > rejected. > [!NOTE] -> `sbx secret set-custom` is an experimental command and isn't listed -> in `sbx secret --help`. It works today but may change in future +> `sbx secret set-custom` is experimental and may change in future > releases. This tutorial surfaces it because there's no other path to > register a custom-format placeholder. @@ -331,5 +330,4 @@ $ sbx secret rm -g --host ampcode.com The `--host` flag on `sbx secret rm` isn't listed in `sbx secret rm --help`, but it's the only way to remove entries -created with `set-custom`. Like `set-custom` itself, it's experimental -and may change. +created with `set-custom`. It's experimental and may change. From 0b0d43d61916ec6642e0efc6744c237518157cfd Mon Sep 17 00:00:00 2001 From: David Karlsson <35727626+dvdksn@users.noreply.github.com> Date: Fri, 5 Jun 2026 14:18:13 +0200 Subject: [PATCH 3/3] sbx: soften wording around hidden --host flag on secret rm Co-Authored-By: Claude Sonnet 4.6 --- content/manuals/ai/sandboxes/customize/build-an-agent.md | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/content/manuals/ai/sandboxes/customize/build-an-agent.md b/content/manuals/ai/sandboxes/customize/build-an-agent.md index 86ca2a0e3e5b..237e25e209e2 100644 --- a/content/manuals/ai/sandboxes/customize/build-an-agent.md +++ b/content/manuals/ai/sandboxes/customize/build-an-agent.md @@ -328,6 +328,4 @@ the host to `sbx secret rm`: $ sbx secret rm -g --host ampcode.com ``` -The `--host` flag on `sbx secret rm` isn't listed in -`sbx secret rm --help`, but it's the only way to remove entries -created with `set-custom`. It's experimental and may change. +The `--host` flag is part of the experimental `set-custom` surface and doesn't appear in `sbx secret rm --help`.