Merge branch 'main' into dev

miloschwartz · miloschwartz · commit 017092f4e0c5 · 2026-05-05T14:15:05.000-07:00
diff --git a/docs/pangolin.md b/docs/pangolin.md
@@ -12,7 +12,9 @@ Pangolin CLI
 
 * [pangolin apply](pangolin_apply.md)	 - Apply commands
 * [pangolin auth](pangolin_auth.md)	 - Authentication commands
+* [pangolin auth-daemon](pangolin_auth-daemon.md)	 - Start the auth daemon
 * [pangolin down](pangolin_down.md)	 - Stop a connection
+* [pangolin list](pangolin_list.md)	 - List resources and other items from the server
 * [pangolin login](pangolin_login.md)	 - Login to Pangolin
 * [pangolin logout](pangolin_logout.md)	 - Logout from Pangolin
 * [pangolin logs](pangolin_logs.md)	 - View client logs
@@ -23,4 +25,3 @@ Pangolin CLI
 * [pangolin update](pangolin_update.md)	 - Update Pangolin CLI to the latest version
 * [pangolin version](pangolin_version.md)	 - Print the version number
 
-###### Auto generated by spf13/cobra on 25-Feb-2026
diff --git a/docs/pangolin_apply.md b/docs/pangolin_apply.md
@@ -17,4 +17,3 @@ Apply resources to the Pangolin server
 * [pangolin](pangolin.md)	 - Pangolin CLI
 * [pangolin apply blueprint](pangolin_apply_blueprint.md)	 - Apply a blueprint
 
-###### Auto generated by spf13/cobra on 25-Feb-2026
diff --git a/docs/pangolin_apply_blueprint.md b/docs/pangolin_apply_blueprint.md
@@ -13,13 +13,15 @@ pangolin apply blueprint [flags]
 ### Options
 
 ```
-  -f, --file string   Path to blueprint file (required)
-  -h, --help          help for blueprint
-  -n, --name string   Name of blueprint (default: filename, without extension)
+      --api-key string    Integration API key (id.secret)
+      --endpoint string   Integration API host URL
+  -f, --file string       Blueprint YAML file path (use '-' for stdin)
+  -h, --help              help for blueprint
+  -n, --name string       Blueprint name (default: filename without extension)
+      --org string        Organization ID
 ```
 
 ### SEE ALSO
 
 * [pangolin apply](pangolin_apply.md)	 - Apply commands
 
-###### Auto generated by spf13/cobra on 25-Feb-2026
diff --git a/docs/pangolin_auth-daemon.md b/docs/pangolin_auth-daemon.md
@@ -13,16 +13,16 @@ pangolin auth-daemon [flags]
 ### Options
 
 ```
-      --ca-cert-path string      Path to the CA certificate file (default "/etc/ssh/ca.pem")
-  -h, --help                     help for auth-daemon
-      --port int                 TCP listen port for the HTTPS server (default 22123)
-      --pre-shared-key string    Preshared key required for all requests to the auth daemon (required)
-      --principals-file string   Path to the principals file (default "/var/run/auth-daemon/principals")
+      --ca-cert-path string        Path to the CA certificate file (default "/etc/ssh/ca.pem")
+      --generate-random-password   Generate a random password for authenticated users
+  -h, --help                       help for auth-daemon
+      --port int                   TCP listen port for the HTTPS server (default 22123)
+      --pre-shared-key string      Preshared key required for all requests to the auth daemon (required). Can also be set via AUTH_DAEMON_PRE_SHARED_KEY env var
+      --principals-file string     Path to the principals file (default "/var/run/auth-daemon/principals")
 ```
 
 ### SEE ALSO
 
 * [pangolin](pangolin.md)	 - Pangolin CLI
 * [pangolin auth-daemon principals](pangolin_auth-daemon_principals.md)	 - Output principals for a username (for AuthorizedPrincipalsCommand in sshd_config)
 
-###### Auto generated by spf13/cobra on 22-Feb-2026
diff --git a/docs/pangolin_auth-daemon_principals.md b/docs/pangolin_auth-daemon_principals.md
@@ -22,4 +22,3 @@ pangolin auth-daemon principals [flags]
 
 * [pangolin auth-daemon](pangolin_auth-daemon.md)	 - Start the auth daemon
 
-###### Auto generated by spf13/cobra on 22-Feb-2026
diff --git a/docs/pangolin_auth.md b/docs/pangolin_auth.md
@@ -19,4 +19,3 @@ Manage authentication and sessions
 * [pangolin auth logout](pangolin_auth_logout.md)	 - Logout from Pangolin
 * [pangolin auth status](pangolin_auth_status.md)	 - Check authentication status
 
-###### Auto generated by spf13/cobra on 25-Feb-2026
diff --git a/docs/pangolin_auth_login.md b/docs/pangolin_auth_login.md
@@ -20,4 +20,3 @@ pangolin auth login [hostname] [flags]
 
 * [pangolin auth](pangolin_auth.md)	 - Authentication commands
 
-###### Auto generated by spf13/cobra on 25-Feb-2026
diff --git a/docs/pangolin_auth_logout.md b/docs/pangolin_auth_logout.md
@@ -20,4 +20,3 @@ pangolin auth logout [flags]
 
 * [pangolin auth](pangolin_auth.md)	 - Authentication commands
 
-###### Auto generated by spf13/cobra on 25-Feb-2026
diff --git a/docs/pangolin_auth_status.md b/docs/pangolin_auth_status.md
@@ -20,4 +20,3 @@ pangolin auth status [flags]
 
 * [pangolin auth](pangolin_auth.md)	 - Authentication commands
 
-###### Auto generated by spf13/cobra on 25-Feb-2026
diff --git a/docs/pangolin_down.md b/docs/pangolin_down.md
@@ -24,4 +24,3 @@ pangolin down [flags]
 * [pangolin](pangolin.md)	 - Pangolin CLI
 * [pangolin down client](pangolin_down_client.md)	 - Stop the client connection
 
-###### Auto generated by spf13/cobra on 25-Feb-2026
diff --git a/docs/pangolin_down_client.md b/docs/pangolin_down_client.md
@@ -20,4 +20,3 @@ pangolin down client [flags]
 
 * [pangolin down](pangolin_down.md)	 - Stop a connection
 
-###### Auto generated by spf13/cobra on 25-Feb-2026
diff --git a/docs/pangolin_list.md b/docs/pangolin_list.md
@@ -0,0 +1,15 @@
+## pangolin list
+
+List resources and other items from the server
+
+### Options
+
+```
+  -h, --help   help for list
+```
+
+### SEE ALSO
+
+* [pangolin](pangolin.md)	 - Pangolin CLI
+* [pangolin list aliases](pangolin_list_aliases.md)	 - Print every private host alias you can reach in the current organization
+
diff --git a/docs/pangolin_list_aliases.md b/docs/pangolin_list_aliases.md
@@ -0,0 +1,22 @@
+## pangolin list aliases
+
+Print every private host alias you can reach in the current organization
+
+### Synopsis
+
+Lists all private site aliases you have access to in your selected organization—one name per line.
+
+```
+pangolin list aliases [flags]
+```
+
+### Options
+
+```
+  -h, --help   help for aliases
+```
+
+### SEE ALSO
+
+* [pangolin list](pangolin_list.md)	 - List resources and other items from the server
+
diff --git a/docs/pangolin_login.md b/docs/pangolin_login.md
@@ -20,4 +20,3 @@ pangolin login [hostname] [flags]
 
 * [pangolin](pangolin.md)	 - Pangolin CLI
 
-###### Auto generated by spf13/cobra on 25-Feb-2026
diff --git a/docs/pangolin_logout.md b/docs/pangolin_logout.md
@@ -20,4 +20,3 @@ pangolin logout [flags]
 
 * [pangolin](pangolin.md)	 - Pangolin CLI
 
-###### Auto generated by spf13/cobra on 25-Feb-2026
diff --git a/docs/pangolin_logs.md b/docs/pangolin_logs.md
@@ -17,4 +17,3 @@ View and follow client logs
 * [pangolin](pangolin.md)	 - Pangolin CLI
 * [pangolin logs client](pangolin_logs_client.md)	 - View client logs
 
-###### Auto generated by spf13/cobra on 25-Feb-2026
diff --git a/docs/pangolin_logs_client.md b/docs/pangolin_logs_client.md
@@ -22,4 +22,3 @@ pangolin logs client [flags]
 
 * [pangolin logs](pangolin_logs.md)	 - View client logs
 
-###### Auto generated by spf13/cobra on 25-Feb-2026
diff --git a/docs/pangolin_select.md b/docs/pangolin_select.md
@@ -18,4 +18,3 @@ Select account information to use
 * [pangolin select account](pangolin_select_account.md)	 - Select an account
 * [pangolin select org](pangolin_select_org.md)	 - Select an organization
 
-###### Auto generated by spf13/cobra on 25-Feb-2026
diff --git a/docs/pangolin_select_account.md b/docs/pangolin_select_account.md
@@ -22,4 +22,3 @@ pangolin select account [flags]
 
 * [pangolin select](pangolin_select.md)	 - Select account information to use
 
-###### Auto generated by spf13/cobra on 25-Feb-2026
diff --git a/docs/pangolin_select_org.md b/docs/pangolin_select_org.md
@@ -21,4 +21,3 @@ pangolin select org [flags]
 
 * [pangolin select](pangolin_select.md)	 - Select account information to use
 
-###### Auto generated by spf13/cobra on 25-Feb-2026
diff --git a/docs/pangolin_ssh.md b/docs/pangolin_ssh.md
@@ -6,21 +6,24 @@ Run an interactive SSH session
 
 Run an SSH client in the terminal. Generates a key pair and signs it just-in-time, then connects to the target resource.
 
+By default the system OpenSSH client is used on every platform. You can pass the same options as ssh(1) after the resource name (for example port forwards: -L, -R, -D, and -N), then an optional remote command. Example: pangolin ssh <resource> -L 8080:127.0.0.1:80 -N
+
+Set PANGOLIN_SSH_BINARY to the full path of ssh(1) to override PATH lookup on all platforms.
+
 ```
 pangolin ssh <resource alias or identifier> [flags]
 ```
 
 ### Options
 
 ```
-      --exec       Use system ssh binary instead of the built-in client
+      --builtin    Use the built-in SSH client instead of the system OpenSSH binary (interactive shell only)
   -h, --help       help for ssh
-  -p, --port int   SSH port (default: 22)
+  -p, --port int   Remote SSH port (default: 22)
 ```
 
 ### SEE ALSO
 
 * [pangolin](pangolin.md)	 - Pangolin CLI
 * [pangolin ssh sign](pangolin_ssh_sign.md)	 - Generate and sign an SSH key, then save to files for use with system SSH.
 
-###### Auto generated by spf13/cobra on 25-Feb-2026
diff --git a/docs/pangolin_ssh_sign.md b/docs/pangolin_ssh_sign.md
@@ -22,4 +22,3 @@ pangolin ssh sign <resource-id> [flags]
 
 * [pangolin ssh](pangolin_ssh.md)	 - Run an interactive SSH session
 
-###### Auto generated by spf13/cobra on 25-Feb-2026
diff --git a/docs/pangolin_status.md b/docs/pangolin_status.md
@@ -25,4 +25,3 @@ pangolin status [flags]
 * [pangolin](pangolin.md)	 - Pangolin CLI
 * [pangolin status client](pangolin_status_client.md)	 - Show client status
 
-###### Auto generated by spf13/cobra on 25-Feb-2026
diff --git a/docs/pangolin_status_client.md b/docs/pangolin_status_client.md
@@ -21,4 +21,3 @@ pangolin status client [flags]
 
 * [pangolin status](pangolin_status.md)	 - Status commands
 
-###### Auto generated by spf13/cobra on 25-Feb-2026
diff --git a/docs/pangolin_up.md b/docs/pangolin_up.md
@@ -25,7 +25,7 @@ pangolin up [flags]
       --interface-name name      Interface name (default "pangolin")
       --log-level string         Log level (default "info")
       --mtu int                  Maximum transmission unit (default 1280)
-      --netstack-dns server      DNS server to use for Netstack (default "1.1.1.1")
+      --netstack-dns server      DNS server to use for Netstack. This handles DNS resolution outside of the upstream servers. (default "1.1.1.1")
       --org string               Organization ID (default: selected organization if logged in)
       --override-dns             When enabled, the client uses custom DNS servers to resolve internal resources and aliases. This overrides your system's default DNS settings. Queries that cannot be resolved as a Pangolin resource will be forwarded to your configured Upstream DNS Server. (default true)
       --ping-interval interval   Ping interval (default 5s)
@@ -42,4 +42,3 @@ pangolin up [flags]
 * [pangolin](pangolin.md)	 - Pangolin CLI
 * [pangolin up client](pangolin_up_client.md)	 - Start a client connection
 
-###### Auto generated by spf13/cobra on 25-Feb-2026
diff --git a/docs/pangolin_up_client.md b/docs/pangolin_up_client.md
@@ -22,7 +22,7 @@ pangolin up client [flags]
       --interface-name name      Interface name (default "pangolin")
       --log-level string         Log level (default "info")
       --mtu int                  Maximum transmission unit (default 1280)
-      --netstack-dns server      DNS server to use for Netstack (default "1.1.1.1")
+      --netstack-dns server      DNS server to use for Netstack. This handles DNS resolution outside of the upstream servers. (default "1.1.1.1")
       --org string               Organization ID (default: selected organization if logged in)
       --override-dns             When enabled, the client uses custom DNS servers to resolve internal resources and aliases. This overrides your system's default DNS settings. Queries that cannot be resolved as a Pangolin resource will be forwarded to your configured Upstream DNS Server. (default true)
       --ping-interval interval   Ping interval (default 5s)
@@ -38,4 +38,3 @@ pangolin up client [flags]
 
 * [pangolin up](pangolin_up.md)	 - Start a connection
 
-###### Auto generated by spf13/cobra on 25-Feb-2026
diff --git a/docs/pangolin_update.md b/docs/pangolin_update.md
@@ -20,4 +20,3 @@ pangolin update [flags]
 
 * [pangolin](pangolin.md)	 - Pangolin CLI
 
-###### Auto generated by spf13/cobra on 25-Feb-2026
diff --git a/docs/pangolin_version.md b/docs/pangolin_version.md
@@ -20,4 +20,3 @@ pangolin version [flags]
 
 * [pangolin](pangolin.md)	 - Pangolin CLI
 
-###### Auto generated by spf13/cobra on 25-Feb-2026

Original file line number	Diff line number	Diff line change
`@@ -17,4 +17,3 @@ Apply resources to the Pangolin server`
`17`	`17`	`* [pangolin](pangolin.md) - Pangolin CLI`
`18`	`18`	`* [pangolin apply blueprint](pangolin_apply_blueprint.md) - Apply a blueprint`
`19`	`19`
`20`		`-###### Auto generated by spf13/cobra on 25-Feb-2026`
Original file line number	Diff line number	Diff line change
`@@ -22,4 +22,3 @@ pangolin auth-daemon principals [flags]`
`22`	`22`
`23`	`23`	`* [pangolin auth-daemon](pangolin_auth-daemon.md) - Start the auth daemon`
`24`	`24`
`25`		`-###### Auto generated by spf13/cobra on 22-Feb-2026`
Original file line number	Diff line number	Diff line change
`@@ -19,4 +19,3 @@ Manage authentication and sessions`
`19`	`19`	`* [pangolin auth logout](pangolin_auth_logout.md) - Logout from Pangolin`
`20`	`20`	`* [pangolin auth status](pangolin_auth_status.md) - Check authentication status`
`21`	`21`
`22`		`-###### Auto generated by spf13/cobra on 25-Feb-2026`
Original file line number	Diff line number	Diff line change
`@@ -20,4 +20,3 @@ pangolin auth login [hostname] [flags]`
`20`	`20`
`21`	`21`	`* [pangolin auth](pangolin_auth.md) - Authentication commands`
`22`	`22`
`23`		`-###### Auto generated by spf13/cobra on 25-Feb-2026`
Original file line number	Diff line number	Diff line change
`@@ -20,4 +20,3 @@ pangolin auth logout [flags]`
`20`	`20`
`21`	`21`	`* [pangolin auth](pangolin_auth.md) - Authentication commands`
`22`	`22`
`23`		`-###### Auto generated by spf13/cobra on 25-Feb-2026`
Original file line number	Diff line number	Diff line change
`@@ -20,4 +20,3 @@ pangolin auth status [flags]`
`20`	`20`
`21`	`21`	`* [pangolin auth](pangolin_auth.md) - Authentication commands`
`22`	`22`
`23`		`-###### Auto generated by spf13/cobra on 25-Feb-2026`
Original file line number	Diff line number	Diff line change
`@@ -24,4 +24,3 @@ pangolin down [flags]`
`24`	`24`	`* [pangolin](pangolin.md) - Pangolin CLI`
`25`	`25`	`* [pangolin down client](pangolin_down_client.md) - Stop the client connection`
`26`	`26`
`27`		`-###### Auto generated by spf13/cobra on 25-Feb-2026`