docs(cli): update --remote flag to -r, document name-based resolution

commit: 40943be2d7d3e59388f066d6c73a4b3c2eaba996
author: brice · 6mo ago · 2026-04-04 11:37 UTC
parent: c58e6af
signature: GPG VerifiedCD88F9E564E0102646FB6077A1A07C7C7C3E349D · arch-gpg Verified for the committer email

13 files · +34 -26

M docs/cli/attachments.md +4 -4


@@ -85,7 +85,7 @@ gordon attachments list --json
85	85		\| Option \| Description \|
86	86		\|--------\|-------------\|
87	87		\| `--json` \| Output attachments as JSON \|
88		-	\| `--remote` \| Remote Gordon URL \|
	88	+	\| `--remote, -r` \| Remote name or URL (e.g., prod, https://gordon.mydomain.com) \|
89	89		\| `--token` \| Authentication token for remote \|
90	90
91	91		---

@@ -111,7 +111,7 @@ gordon attachments add backend redis:7-alpine
111	111
112	112		\| Option \| Description \|
113	113		\|--------\|-------------\|
114		-	\| `--remote` \| Remote Gordon URL \|
	114	+	\| `--remote, -r` \| Remote name or URL (e.g., prod, https://gordon.mydomain.com) \|
115	115		\| `--token` \| Authentication token for remote \|
116	116
117	117		### Examples

@@ -152,7 +152,7 @@ gordon attachments push <image> [options]
152	152		\| `--platform` \| Target platform for buildx (default: `linux/amd64`) \|
153	153		\| `--build-arg` \| Additional build args (repeatable, `KEY=VALUE`) \|
154	154		\| `--tag` \| Override version tag \|
155		-	\| `--remote` \| Remote Gordon URL \|
	155	+	\| `--remote, -r` \| Remote name or URL (e.g., prod, https://gordon.mydomain.com) \|
156	156		\| `--token` \| Authentication token for remote \|
157	157
158	158		### Description

@@ -199,7 +199,7 @@ gordon attachments remove app.example.com postgres:18
199	199
200	200		\| Option \| Description \|
201	201		\|--------\|-------------\|
202		-	\| `--remote` \| Remote Gordon URL \|
	202	+	\| `--remote, -r` \| Remote name or URL (e.g., prod, https://gordon.mydomain.com) \|
203	203		\| `--token` \| Authentication token for remote \|
204	204
205	205		### Examples


@@ -85,7 +85,7 @@ gordon attachments list --json
85		\| Option \| Description \|	85		\| Option \| Description \|
86		\|--------\|-------------\|	86		\|--------\|-------------\|
87		\| `--json` \| Output attachments as JSON \|	87		\| `--json` \| Output attachments as JSON \|
88	-	\| `--remote` \| Remote Gordon URL \|	88	+	\| `--remote, -r` \| Remote name or URL (e.g., prod, https://gordon.mydomain.com) \|
89		\| `--token` \| Authentication token for remote \|	89		\| `--token` \| Authentication token for remote \|
90			90
91		---	91		---

@@ -111,7 +111,7 @@ gordon attachments add backend redis:7-alpine
111			111
112		\| Option \| Description \|	112		\| Option \| Description \|
113		\|--------\|-------------\|	113		\|--------\|-------------\|
114	-	\| `--remote` \| Remote Gordon URL \|	114	+	\| `--remote, -r` \| Remote name or URL (e.g., prod, https://gordon.mydomain.com) \|
115		\| `--token` \| Authentication token for remote \|	115		\| `--token` \| Authentication token for remote \|
116			116
117		### Examples	117		### Examples

@@ -152,7 +152,7 @@ gordon attachments push <image> [options]
152		\| `--platform` \| Target platform for buildx (default: `linux/amd64`) \|	152		\| `--platform` \| Target platform for buildx (default: `linux/amd64`) \|
153		\| `--build-arg` \| Additional build args (repeatable, `KEY=VALUE`) \|	153		\| `--build-arg` \| Additional build args (repeatable, `KEY=VALUE`) \|
154		\| `--tag` \| Override version tag \|	154		\| `--tag` \| Override version tag \|
155	-	\| `--remote` \| Remote Gordon URL \|	155	+	\| `--remote, -r` \| Remote name or URL (e.g., prod, https://gordon.mydomain.com) \|
156		\| `--token` \| Authentication token for remote \|	156		\| `--token` \| Authentication token for remote \|
157			157
158		### Description	158		### Description

@@ -199,7 +199,7 @@ gordon attachments remove app.example.com postgres:18
199			199
200		\| Option \| Description \|	200		\| Option \| Description \|
201		\|--------\|-------------\|	201		\|--------\|-------------\|
202	-	\| `--remote` \| Remote Gordon URL \|	202	+	\| `--remote, -r` \| Remote name or URL (e.g., prod, https://gordon.mydomain.com) \|
203		\| `--token` \| Authentication token for remote \|	203		\| `--token` \| Authentication token for remote \|
204			204
205		### Examples	205		### Examples

M docs/cli/auth.md +4 -2


@@ -32,7 +32,8 @@ gordon auth login --token <token> [options]
32	32		\| Option \| Description \|
33	33		\|--------\|-------------\|
34	34		\| `-t, --token` \| Required. Authentication token to store \|
35		-	\| `-r, --remote` \| Remote to authenticate with (defaults to active remote) \|
	35	+
	36	+	Use the global `--remote, -r` flag to target a specific remote. See [CLI Overview](./index.md).
36	37
37	38		### Description
38	39

@@ -94,9 +95,10 @@ gordon auth logout [--remote <name>] [--revoke]
94	95
95	96		\| Option \| Description \|
96	97		\|--------\|-------------\|
97		-	\| `-r, --remote` \| Remote to log out from (defaults to active remote) \|
98	98		\| `--revoke` \| Also revoke the token server-side (not yet implemented) \|
99	99
	100	+	Use the global `--remote, -r` flag to target a specific remote. See [CLI Overview](./index.md).
	101	+
100	102		Deletes the token from pass and clears token fields in `remotes.toml`.
101	103
102	104		---


@@ -32,7 +32,8 @@ gordon auth login --token <token> [options]
32		\| Option \| Description \|	32		\| Option \| Description \|
33		\|--------\|-------------\|	33		\|--------\|-------------\|
34		\| `-t, --token` \| Required. Authentication token to store \|	34		\| `-t, --token` \| Required. Authentication token to store \|
35	-	\| `-r, --remote` \| Remote to authenticate with (defaults to active remote) \|	35	+
			36	+	Use the global `--remote, -r` flag to target a specific remote. See [CLI Overview](./index.md).
36			37
37		### Description	38		### Description
38			39

@@ -94,9 +95,10 @@ gordon auth logout [--remote <name>] [--revoke]
94			95
95		\| Option \| Description \|	96		\| Option \| Description \|
96		\|--------\|-------------\|	97		\|--------\|-------------\|
97	-	\| `-r, --remote` \| Remote to log out from (defaults to active remote) \|
98		\| `--revoke` \| Also revoke the token server-side (not yet implemented) \|	98		\| `--revoke` \| Also revoke the token server-side (not yet implemented) \|
99			99
			100	+	Use the global `--remote, -r` flag to target a specific remote. See [CLI Overview](./index.md).
			101	+
100		Deletes the token from pass and clears token fields in `remotes.toml`.	102		Deletes the token from pass and clears token fields in `remotes.toml`.
101			103
102		---	104		---

M docs/cli/autoroute.md +3 -3


@@ -59,7 +59,7 @@ gordon autoroute allow add example.com --remote https://gordon.mydomain.com --to
59	59
60	60		\| Option \| Description \|
61	61		\|--------\|-------------\|
62		-	\| `--remote` \| Remote Gordon URL \|
	62	+	\| `--remote, -r` \| Remote name or URL (e.g., prod, https://gordon.mydomain.com) \|
63	63		\| `--token` \| Authentication token for remote \|
64	64
65	65		### Description

@@ -103,7 +103,7 @@ gordon autoroute allow list --remote https://gordon.mydomain.com --token $TOKEN
103	103		\| Option \| Description \|
104	104		\|--------\|-------------\|
105	105		\| `--json` \| Output allowed domains as JSON \|
106		-	\| `--remote` \| Remote Gordon URL \|
	106	+	\| `--remote, -r` \| Remote name or URL (e.g., prod, https://gordon.mydomain.com) \|
107	107		\| `--token` \| Authentication token for remote \|
108	108
109	109		### Description

@@ -171,7 +171,7 @@ gordon autoroute allow remove example.com --remote https://gordon.mydomain.com -
171	171
172	172		\| Option \| Description \|
173	173		\|--------\|-------------\|
174		-	\| `--remote` \| Remote Gordon URL \|
	174	+	\| `--remote, -r` \| Remote name or URL (e.g., prod, https://gordon.mydomain.com) \|
175	175		\| `--token` \| Authentication token for remote \|
176	176
177	177		### Description


@@ -59,7 +59,7 @@ gordon autoroute allow add example.com --remote https://gordon.mydomain.com --to
59			59
60		\| Option \| Description \|	60		\| Option \| Description \|
61		\|--------\|-------------\|	61		\|--------\|-------------\|
62	-	\| `--remote` \| Remote Gordon URL \|	62	+	\| `--remote, -r` \| Remote name or URL (e.g., prod, https://gordon.mydomain.com) \|
63		\| `--token` \| Authentication token for remote \|	63		\| `--token` \| Authentication token for remote \|
64			64
65		### Description	65		### Description

@@ -103,7 +103,7 @@ gordon autoroute allow list --remote https://gordon.mydomain.com --token $TOKEN
103		\| Option \| Description \|	103		\| Option \| Description \|
104		\|--------\|-------------\|	104		\|--------\|-------------\|
105		\| `--json` \| Output allowed domains as JSON \|	105		\| `--json` \| Output allowed domains as JSON \|
106	-	\| `--remote` \| Remote Gordon URL \|	106	+	\| `--remote, -r` \| Remote name or URL (e.g., prod, https://gordon.mydomain.com) \|
107		\| `--token` \| Authentication token for remote \|	107		\| `--token` \| Authentication token for remote \|
108			108
109		### Description	109		### Description

@@ -171,7 +171,7 @@ gordon autoroute allow remove example.com --remote https://gordon.mydomain.com -
171			171
172		\| Option \| Description \|	172		\| Option \| Description \|
173		\|--------\|-------------\|	173		\|--------\|-------------\|
174	-	\| `--remote` \| Remote Gordon URL \|	174	+	\| `--remote, -r` \| Remote name or URL (e.g., prod, https://gordon.mydomain.com) \|
175		\| `--token` \| Authentication token for remote \|	175		\| `--token` \| Authentication token for remote \|
176			176
177		### Description	177		### Description

M docs/cli/bootstrap.md +1 -1


@@ -23,7 +23,7 @@ gordon bootstrap <domain> <image> [options]
23	23		\|--------\|-------------\|
24	24		\| `--attachment` \| Add an attachment to the route (repeatable) \|
25	25		\| `--env` \| Set an environment variable for the route (repeatable, `KEY=VALUE`) \|
26		-	\| `--remote` \| Remote Gordon URL \|
	26	+	\| `--remote, -r` \| Remote name or URL (e.g., prod, https://gordon.mydomain.com) \|
27	27		\| `--token` \| Authentication token for remote \|
28	28
29	29		### Description


@@ -23,7 +23,7 @@ gordon bootstrap <domain> <image> [options]
23		\|--------\|-------------\|	23		\|--------\|-------------\|
24		\| `--attachment` \| Add an attachment to the route (repeatable) \|	24		\| `--attachment` \| Add an attachment to the route (repeatable) \|
25		\| `--env` \| Set an environment variable for the route (repeatable, `KEY=VALUE`) \|	25		\| `--env` \| Set an environment variable for the route (repeatable, `KEY=VALUE`) \|
26	-	\| `--remote` \| Remote Gordon URL \|	26	+	\| `--remote, -r` \| Remote name or URL (e.g., prod, https://gordon.mydomain.com) \|
27		\| `--token` \| Authentication token for remote \|	27		\| `--token` \| Authentication token for remote \|
28			28
29		### Description	29		### Description

M docs/cli/index.md +1 -1


@@ -157,7 +157,7 @@ gordon autoroute allow remove example.com
157	157		\| Option \| Description \|
158	158		\|--------\|-------------\|
159	159		\| `-c, --config` \| Path to configuration file \|
160		-	\| `--remote` \| Remote Gordon URL (e.g., `https://gordon.mydomain.com`) \|
	160	+	\| `--remote, -r` \| Remote name or URL (e.g., prod, https://gordon.mydomain.com) \|
161	161		\| `--token` \| Authentication token for remote \|
162	162		\| `--insecure` \| Skip TLS certificate verification for remote HTTPS endpoints \|
163	163


@@ -157,7 +157,7 @@ gordon autoroute allow remove example.com
157		\| Option \| Description \|	157		\| Option \| Description \|
158		\|--------\|-------------\|	158		\|--------\|-------------\|
159		\| `-c, --config` \| Path to configuration file \|	159		\| `-c, --config` \| Path to configuration file \|
160	-	\| `--remote` \| Remote Gordon URL (e.g., `https://gordon.mydomain.com`) \|	160	+	\| `--remote, -r` \| Remote name or URL (e.g., prod, https://gordon.mydomain.com) \|
161		\| `--token` \| Authentication token for remote \|	161		\| `--token` \| Authentication token for remote \|
162		\| `--insecure` \| Skip TLS certificate verification for remote HTTPS endpoints \|	162		\| `--insecure` \| Skip TLS certificate verification for remote HTTPS endpoints \|
163			163

M docs/cli/push.md +1 -1


@@ -28,7 +28,7 @@ gordon push [image] [options]
28	28		\| `--no-confirm` \| Skip deploy confirmation prompt \|
29	29		\| `--no-deploy` \| Push only; skip deployment prompt \|
30	30		\| `--domain` \| Explicit domain override (legacy mode) \|
31		-	\| `--remote` \| Remote Gordon URL \|
	31	+	\| `--remote, -r` \| Remote name or URL (e.g., prod, https://gordon.mydomain.com) \|
32	32		\| `--token` \| Authentication token for remote \|
33	33
34	34		### Description


@@ -28,7 +28,7 @@ gordon push [image] [options]
28		\| `--no-confirm` \| Skip deploy confirmation prompt \|	28		\| `--no-confirm` \| Skip deploy confirmation prompt \|
29		\| `--no-deploy` \| Push only; skip deployment prompt \|	29		\| `--no-deploy` \| Push only; skip deployment prompt \|
30		\| `--domain` \| Explicit domain override (legacy mode) \|	30		\| `--domain` \| Explicit domain override (legacy mode) \|
31	-	\| `--remote` \| Remote Gordon URL \|	31	+	\| `--remote, -r` \| Remote name or URL (e.g., prod, https://gordon.mydomain.com) \|
32		\| `--token` \| Authentication token for remote \|	32		\| `--token` \| Authentication token for remote \|
33			33
34		### Description	34		### Description

M docs/cli/remotes.md +6 -0


@@ -337,6 +337,12 @@ If you have your own certificate for the domain (e.g. from a corporate CA), you
337	337
338	338		`insecure_tls` only affects CLI -> Gordon admin HTTPS verification. It does not change runtime routing: Gordon reverse proxy and container routes can still serve wildcard app domains like `*.example.com`.
339	339
	340	+	## Migration from [client] Config
	341	+
	342	+	The `[client]` section in `gordon.toml` is deprecated. On first run, Gordon
	343	+	auto-migrates it to a `default` remote entry in `remotes.toml` and sets it
	344	+	as active. No manual action needed.
	345	+
340	346		## Related
341	347
342	348		- [CLI Overview](./index.md)


@@ -337,6 +337,12 @@ If you have your own certificate for the domain (e.g. from a corporate CA), you
337		337
338	`insecure_tls` only affects CLI -> Gordon admin HTTPS verification. It does not change runtime routing: Gordon reverse proxy and container routes can still serve wildcard app domains like `*.example.com`.	338		`insecure_tls` only affects CLI -> Gordon admin HTTPS verification. It does not change runtime routing: Gordon reverse proxy and container routes can still serve wildcard app domains like `*.example.com`.
339		339
		340	+	## Migration from [client] Config
		341	+
		342	+	The `[client]` section in `gordon.toml` is deprecated. On first run, Gordon
		343	+	auto-migrates it to a `default` remote entry in `remotes.toml` and sets it
		344	+	as active. No manual action needed.
		345	+
340	## Related	346		## Related
341		347
342	- [CLI Overview](./index.md)	348		- [CLI Overview](./index.md)

M docs/cli/restart.md +1 -1


@@ -21,7 +21,7 @@ gordon restart <domain> [options]
21	21		\| Option \| Description \|
22	22		\|--------\|-------------\|
23	23		\| `--with-attachments` \| Also restart attached services (databases, caches) \|
24		-	\| `--remote` \| Remote Gordon URL \|
	24	+	\| `--remote, -r` \| Remote name or URL (e.g., prod, https://gordon.mydomain.com) \|
25	25		\| `--token` \| Authentication token for remote \|
26	26
27	27		### Description


@@ -21,7 +21,7 @@ gordon restart <domain> [options]
21		\| Option \| Description \|	21		\| Option \| Description \|
22		\|--------\|-------------\|	22		\|--------\|-------------\|
23		\| `--with-attachments` \| Also restart attached services (databases, caches) \|	23		\| `--with-attachments` \| Also restart attached services (databases, caches) \|
24	-	\| `--remote` \| Remote Gordon URL \|	24	+	\| `--remote, -r` \| Remote name or URL (e.g., prod, https://gordon.mydomain.com) \|
25		\| `--token` \| Authentication token for remote \|	25		\| `--token` \| Authentication token for remote \|
26			26
27		### Description	27		### Description

M docs/cli/rollback.md +1 -1


@@ -22,7 +22,7 @@ gordon rollback list <domain>
22	22		\| Option \| Description \|
23	23		\|--------\|-------------\|
24	24		\| `--tag` \| Target tag (skips interactive selection) \|
25		-	\| `--remote` \| Remote Gordon URL \|
	25	+	\| `--remote, -r` \| Remote name or URL (e.g., prod, https://gordon.mydomain.com) \|
26	26		\| `--token` \| Authentication token for remote \|
27	27
28	28		### Description


@@ -22,7 +22,7 @@ gordon rollback list <domain>
22		\| Option \| Description \|	22		\| Option \| Description \|
23		\|--------\|-------------\|	23		\|--------\|-------------\|
24		\| `--tag` \| Target tag (skips interactive selection) \|	24		\| `--tag` \| Target tag (skips interactive selection) \|
25	-	\| `--remote` \| Remote Gordon URL \|	25	+	\| `--remote, -r` \| Remote name or URL (e.g., prod, https://gordon.mydomain.com) \|
26		\| `--token` \| Authentication token for remote \|	26		\| `--token` \| Authentication token for remote \|
27			27
28		### Description	28		### Description

M docs/cli/routes.md +5 -5


@@ -65,7 +65,7 @@ gordon routes list --json
65	65		\| Option \| Description \|
66	66		\|--------\|-------------\|
67	67		\| `--json` \| Output routes as JSON \|
68		-	\| `--remote` \| Remote Gordon URL \|
	68	+	\| `--remote, -r` \| Remote name or URL (e.g., prod, https://gordon.mydomain.com) \|
69	69		\| `--token` \| Authentication token for remote \|
70	70
71	71		---

@@ -93,7 +93,7 @@ The image does not need to be pushed to the Gordon registry before you add the r
93	93
94	94		\| Option \| Description \|
95	95		\|--------\|-------------\|
96		-	\| `--remote` \| Remote Gordon URL \|
	96	+	\| `--remote, -r` \| Remote name or URL (e.g., prod, https://gordon.mydomain.com) \|
97	97		\| `--token` \| Authentication token for remote \|
98	98
99	99		### Examples

@@ -138,7 +138,7 @@ gordon routes show myapp.example.com --json
138	138		\| Option \| Description \|
139	139		\|--------\|-------------\|
140	140		\| `--json` \| Output route details as JSON \|
141		-	\| `--remote` \| Remote Gordon URL \|
	141	+	\| `--remote, -r` \| Remote name or URL (e.g., prod, https://gordon.mydomain.com) \|
142	142		\| `--token` \| Authentication token for remote \|
143	143
144	144		### Description

@@ -191,7 +191,7 @@ gordon routes remove myapp.example.com
191	191
192	192		\| Option \| Description \|
193	193		\|--------\|-------------\|
194		-	\| `--remote` \| Remote Gordon URL \|
	194	+	\| `--remote, -r` \| Remote name or URL (e.g., prod, https://gordon.mydomain.com) \|
195	195		\| `--token` \| Authentication token for remote \|
196	196
197	197		### Examples

@@ -225,7 +225,7 @@ gordon routes deploy myapp.example.com
225	225
226	226		\| Option \| Description \|
227	227		\|--------\|-------------\|
228		-	\| `--remote` \| Remote Gordon URL \|
	228	+	\| `--remote, -r` \| Remote name or URL (e.g., prod, https://gordon.mydomain.com) \|
229	229		\| `--token` \| Authentication token for remote \|
230	230
231	231		### Description


@@ -65,7 +65,7 @@ gordon routes list --json
65		\| Option \| Description \|	65		\| Option \| Description \|
66		\|--------\|-------------\|	66		\|--------\|-------------\|
67		\| `--json` \| Output routes as JSON \|	67		\| `--json` \| Output routes as JSON \|
68	-	\| `--remote` \| Remote Gordon URL \|	68	+	\| `--remote, -r` \| Remote name or URL (e.g., prod, https://gordon.mydomain.com) \|
69		\| `--token` \| Authentication token for remote \|	69		\| `--token` \| Authentication token for remote \|
70			70
71		---	71		---

@@ -93,7 +93,7 @@ The image does not need to be pushed to the Gordon registry before you add the r
93			93
94		\| Option \| Description \|	94		\| Option \| Description \|
95		\|--------\|-------------\|	95		\|--------\|-------------\|
96	-	\| `--remote` \| Remote Gordon URL \|	96	+	\| `--remote, -r` \| Remote name or URL (e.g., prod, https://gordon.mydomain.com) \|
97		\| `--token` \| Authentication token for remote \|	97		\| `--token` \| Authentication token for remote \|
98			98
99		### Examples	99		### Examples

@@ -138,7 +138,7 @@ gordon routes show myapp.example.com --json
138		\| Option \| Description \|	138		\| Option \| Description \|
139		\|--------\|-------------\|	139		\|--------\|-------------\|
140		\| `--json` \| Output route details as JSON \|	140		\| `--json` \| Output route details as JSON \|
141	-	\| `--remote` \| Remote Gordon URL \|	141	+	\| `--remote, -r` \| Remote name or URL (e.g., prod, https://gordon.mydomain.com) \|
142		\| `--token` \| Authentication token for remote \|	142		\| `--token` \| Authentication token for remote \|
143			143
144		### Description	144		### Description

@@ -191,7 +191,7 @@ gordon routes remove myapp.example.com
191			191
192		\| Option \| Description \|	192		\| Option \| Description \|
193		\|--------\|-------------\|	193		\|--------\|-------------\|
194	-	\| `--remote` \| Remote Gordon URL \|	194	+	\| `--remote, -r` \| Remote name or URL (e.g., prod, https://gordon.mydomain.com) \|
195		\| `--token` \| Authentication token for remote \|	195		\| `--token` \| Authentication token for remote \|
196			196
197		### Examples	197		### Examples

@@ -225,7 +225,7 @@ gordon routes deploy myapp.example.com
225			225
226		\| Option \| Description \|	226		\| Option \| Description \|
227		\|--------\|-------------\|	227		\|--------\|-------------\|
228	-	\| `--remote` \| Remote Gordon URL \|	228	+	\| `--remote, -r` \| Remote name or URL (e.g., prod, https://gordon.mydomain.com) \|
229		\| `--token` \| Authentication token for remote \|	229		\| `--token` \| Authentication token for remote \|
230			230
231		### Description	231		### Description

M docs/cli/secrets.md +3 -3


@@ -40,7 +40,7 @@ gordon secrets list <domain>
40	40		\| Option \| Description \|
41	41		\|--------\|-------------\|
42	42		\| `--json` \| Output secrets as JSON \|
43		-	\| `--remote` \| Remote Gordon URL \|
	43	+	\| `--remote, -r` \| Remote name or URL (e.g., prod, https://gordon.mydomain.com) \|
44	44		\| `--token` \| Authentication token for remote \|
45	45
46	46		### Examples

@@ -117,7 +117,7 @@ gordon secrets set myapp.local DATABASE_URL "postgres://..."
117	117		\| Option \| Description \|
118	118		\|--------\|-------------\|
119	119		\| `--attachment` / `-a` \| Target an attachment service (e.g., postgres, redis) \|
120		-	\| `--remote` \| Remote Gordon URL \|
	120	+	\| `--remote, -r` \| Remote name or URL (e.g., prod, https://gordon.mydomain.com) \|
121	121		\| `--token` \| Authentication token for remote \|
122	122
123	123		### Examples

@@ -160,7 +160,7 @@ gordon secrets remove <domain> <key>
160	160		\| Option \| Description \|
161	161		\|--------\|-------------\|
162	162		\| `--attachment` / `-a` \| Target an attachment service (e.g., postgres, redis) \|
163		-	\| `--remote` \| Remote Gordon URL \|
	163	+	\| `--remote, -r` \| Remote name or URL (e.g., prod, https://gordon.mydomain.com) \|
164	164		\| `--token` \| Authentication token for remote \|
165	165
166	166		### Examples


@@ -40,7 +40,7 @@ gordon secrets list <domain>
40		\| Option \| Description \|	40		\| Option \| Description \|
41		\|--------\|-------------\|	41		\|--------\|-------------\|
42		\| `--json` \| Output secrets as JSON \|	42		\| `--json` \| Output secrets as JSON \|
43	-	\| `--remote` \| Remote Gordon URL \|	43	+	\| `--remote, -r` \| Remote name or URL (e.g., prod, https://gordon.mydomain.com) \|
44		\| `--token` \| Authentication token for remote \|	44		\| `--token` \| Authentication token for remote \|
45			45
46		### Examples	46		### Examples

@@ -117,7 +117,7 @@ gordon secrets set myapp.local DATABASE_URL "postgres://..."
117		\| Option \| Description \|	117		\| Option \| Description \|
118		\|--------\|-------------\|	118		\|--------\|-------------\|
119		\| `--attachment` / `-a` \| Target an attachment service (e.g., postgres, redis) \|	119		\| `--attachment` / `-a` \| Target an attachment service (e.g., postgres, redis) \|
120	-	\| `--remote` \| Remote Gordon URL \|	120	+	\| `--remote, -r` \| Remote name or URL (e.g., prod, https://gordon.mydomain.com) \|
121		\| `--token` \| Authentication token for remote \|	121		\| `--token` \| Authentication token for remote \|
122			122
123		### Examples	123		### Examples

@@ -160,7 +160,7 @@ gordon secrets remove <domain> <key>
160		\| Option \| Description \|	160		\| Option \| Description \|
161		\|--------\|-------------\|	161		\|--------\|-------------\|
162		\| `--attachment` / `-a` \| Target an attachment service (e.g., postgres, redis) \|	162		\| `--attachment` / `-a` \| Target an attachment service (e.g., postgres, redis) \|
163	-	\| `--remote` \| Remote Gordon URL \|	163	+	\| `--remote, -r` \| Remote name or URL (e.g., prod, https://gordon.mydomain.com) \|
164		\| `--token` \| Authentication token for remote \|	164		\| `--token` \| Authentication token for remote \|
165			165
166		### Examples	166		### Examples

M docs/cli/serve.md +2 -2


@@ -169,7 +169,7 @@ gordon deploy <domain> [options]
169	169
170	170		\| Option \| Description \|
171	171		\|--------\|-------------\|
172		-	\| `--remote` \| Remote Gordon URL \|
	172	+	\| `--remote, -r` \| Remote name or URL (e.g., prod, https://gordon.mydomain.com) \|
173	173		\| `--token` \| Authentication token for remote \|
174	174
175	175		Remote targeting uses client config or an active remote by default.

@@ -229,7 +229,7 @@ gordon logs [domain] [options]
229	229		\| `--config` \| `-c` \| Auto \| Path to config file \|
230	230		\| `--follow` \| `-f` \| false \| Follow log output (like `tail -f`) \|
231	231		\| `--lines` \| `-n` \| 50 \| Number of lines to show \|
232		-	\| `--remote` \| \| \| Remote Gordon URL \|
	232	+	\| `--remote, -r` \| \| \| Remote name or URL (e.g., prod, https://gordon.mydomain.com) \|
233	233		\| `--token` \| \| \| Authentication token for remote \|
234	234
235	235		Remote targeting uses client config or an active remote by default.


@@ -169,7 +169,7 @@ gordon deploy <domain> [options]
169			169
170		\| Option \| Description \|	170		\| Option \| Description \|
171		\|--------\|-------------\|	171		\|--------\|-------------\|
172	-	\| `--remote` \| Remote Gordon URL \|	172	+	\| `--remote, -r` \| Remote name or URL (e.g., prod, https://gordon.mydomain.com) \|
173		\| `--token` \| Authentication token for remote \|	173		\| `--token` \| Authentication token for remote \|
174			174
175		Remote targeting uses client config or an active remote by default.	175		Remote targeting uses client config or an active remote by default.

@@ -229,7 +229,7 @@ gordon logs [domain] [options]
229		\| `--config` \| `-c` \| Auto \| Path to config file \|	229		\| `--config` \| `-c` \| Auto \| Path to config file \|
230		\| `--follow` \| `-f` \| false \| Follow log output (like `tail -f`) \|	230		\| `--follow` \| `-f` \| false \| Follow log output (like `tail -f`) \|
231		\| `--lines` \| `-n` \| 50 \| Number of lines to show \|	231		\| `--lines` \| `-n` \| 50 \| Number of lines to show \|
232	-	\| `--remote` \| \| \| Remote Gordon URL \|	232	+	\| `--remote, -r` \| \| \| Remote name or URL (e.g., prod, https://gordon.mydomain.com) \|
233		\| `--token` \| \| \| Authentication token for remote \|	233		\| `--token` \| \| \| Authentication token for remote \|
234			234
235		Remote targeting uses client config or an active remote by default.	235		Remote targeting uses client config or an active remote by default.

M docs/cli/status.md +2 -2


@@ -62,14 +62,14 @@ The status command uses global flags for remote access:
62	62
63	63		\| Flag \| Description \|
64	64		\|------\|-------------\|
65		-	\| `--remote` \| Remote Gordon URL \|
	65	+	\| `--remote, -r` \| Remote name or URL (e.g., prod, https://gordon.mydomain.com) \|
66	66		\| `--token` \| Authentication token \|
67	67
68	68		## Environment Variables
69	69
70	70		\| Variable \| Description \|
71	71		\|----------\|-------------\|
72		-	\| `GORDON_REMOTE` \| Remote Gordon URL \|
	72	+	\| `GORDON_REMOTE` \| Remote name or URL (e.g., prod, https://gordon.mydomain.com) \|
73	73		\| `GORDON_TOKEN` \| Authentication token \|
74	74
75	75		## Examples


@@ -62,14 +62,14 @@ The status command uses global flags for remote access:
62			62
63		\| Flag \| Description \|	63		\| Flag \| Description \|
64		\|------\|-------------\|	64		\|------\|-------------\|
65	-	\| `--remote` \| Remote Gordon URL \|	65	+	\| `--remote, -r` \| Remote name or URL (e.g., prod, https://gordon.mydomain.com) \|
66		\| `--token` \| Authentication token \|	66		\| `--token` \| Authentication token \|
67			67
68		## Environment Variables	68		## Environment Variables
69			69
70		\| Variable \| Description \|	70		\| Variable \| Description \|
71		\|----------\|-------------\|	71		\|----------\|-------------\|
72	-	\| `GORDON_REMOTE` \| Remote Gordon URL \|	72	+	\| `GORDON_REMOTE` \| Remote name or URL (e.g., prod, https://gordon.mydomain.com) \|
73		\| `GORDON_TOKEN` \| Authentication token \|	73		\| `GORDON_TOKEN` \| Authentication token \|
74			74
75		## Examples	75		## Examples