Skip to content

High-performance browser automation bridge and multi-instance orchestrator with advanced stealth injection and real-time dashboard.

docs: updating the docs on config token access

Luigi Agostif0ac559c2777
diff --git a/docs/commands.md b/docs/commands.md
index 5d89e17e..4160a386 100644
--- a/docs/commands.md
+++ b/docs/commands.md
@@ -178,6 +178,7 @@ pinchtab health # Check server health
pinchtab config # Interactive config overview/editor
pinchtab config init # Create a default config file
pinchtab config show # Print effective runtime config
+pinchtab config token # Copy server.token to the clipboard without printing it
pinchtab config path # Print config file path
pinchtab config validate # Validate the current config file
pinchtab config get <path> # Read one file-config value
diff --git a/docs/guides/mcp-agents.md b/docs/guides/mcp-agents.md
index 2af83d42..eeeccc6a 100644
--- a/docs/guides/mcp-agents.md
+++ b/docs/guides/mcp-agents.md
@@ -113,7 +113,7 @@ proc = subprocess.Popen(
For remote servers, use the `--server` flag: `pinchtab --server http://remote:9867 mcp`
-`PINCHTAB_TOKEN` can be found in `~/.config/pinchtab/config.yaml` under `server.token`, or by running `pinchtab config show`.
+`PINCHTAB_TOKEN` comes from `server.token` in your PinchTab config file. To copy the current token without printing it to stdout, run `pinchtab config token`.
## Typical Agent Workflow
diff --git a/docs/guides/security.md b/docs/guides/security.md
index ab83c325..2c59ed3c 100644
--- a/docs/guides/security.md
+++ b/docs/guides/security.md
@@ -127,7 +127,7 @@ Recommended practice:
pinchtab config init
```
-You can also generate one from the dashboard Settings page or let `pinchtab security` restore create one if `server.token` is empty.
+The dashboard Settings page does not expose or rotate `server.token`. Use `pinchtab config token` to copy the current token, or let `pinchtab security` restore or create one if `server.token` is empty.
If you are calling the API manually:
diff --git a/docs/reference/config.md b/docs/reference/config.md
index 9556be8b..f82a806d 100644
--- a/docs/reference/config.md
+++ b/docs/reference/config.md
@@ -46,6 +46,20 @@ Shows the effective runtime configuration.
pinchtab config show
```
+Secret values such as `server.token` remain masked in this output.
+
+### `pinchtab config token`
+
+Copies the configured `server.token` to the system clipboard without printing it
+to stdout.
+
+```bash
+pinchtab config token
+```
+
+If clipboard access is unavailable, the command reports that safely and still
+does not print the token.
+
### `pinchtab config path`
Prints the config file path PinchTab will read.