devlanes 0.6.1 → 0.7.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "devlanes",
3
- "version": "0.6.1",
3
+ "version": "0.7.1",
4
4
  "description": "Development environments in Git worktree lanes",
5
5
  "license": "Apache-2.0",
6
6
  "homepage": "https://devlanes.run",
@@ -30,11 +30,11 @@
30
30
  "node": ">=18"
31
31
  },
32
32
  "optionalDependencies": {
33
- "@devlanes/darwin-arm64": "0.6.1",
34
- "@devlanes/darwin-x64": "0.6.1",
35
- "@devlanes/linux-arm64": "0.6.1",
36
- "@devlanes/linux-x64": "0.6.1",
37
- "@devlanes/win32-arm64": "0.6.1",
38
- "@devlanes/win32-x64": "0.6.1"
33
+ "@devlanes/darwin-arm64": "0.7.1",
34
+ "@devlanes/darwin-x64": "0.7.1",
35
+ "@devlanes/linux-arm64": "0.7.1",
36
+ "@devlanes/linux-x64": "0.7.1",
37
+ "@devlanes/win32-arm64": "0.7.1",
38
+ "@devlanes/win32-x64": "0.7.1"
39
39
  }
40
40
  }
package/schema.json CHANGED
@@ -202,6 +202,199 @@
202
202
  },
203
203
  "type": "object"
204
204
  },
205
+ "ExternalConfig": {
206
+ "additionalProperties": false,
207
+ "description": "A server you run yourself on a loopback port. Every lane of the project lists it, the proxy routes its hostnames to the port, and machines connected with `devlanes remote connect` mirror it while a lane of the project runs. The port is the same in every lane.",
208
+ "examples": [
209
+ {
210
+ "address": "127.0.0.1:5050",
211
+ "hosts": "pgadmin.${{ lane.domain }}"
212
+ },
213
+ {
214
+ "address": "[::1]:8000",
215
+ "hidden": true
216
+ }
217
+ ],
218
+ "markdownDescription": "A server you run yourself on a loopback port. Every lane of the project lists it, the proxy routes its hostnames to the port, and machines connected with `devlanes remote connect` mirror it while a lane of the project runs. The port is the same in every lane.",
219
+ "properties": {
220
+ "address": {
221
+ "description": "Where the server listens, `127.0.0.1:<port>` or `[::1]:<port>`. Only loopback addresses work. A port that devlanes or a lane already uses is an error. Required.",
222
+ "examples": [
223
+ "127.0.0.1:5050",
224
+ "[::1]:8000"
225
+ ],
226
+ "markdownDescription": "Where the server listens, `127.0.0.1:<port>` or `[::1]:<port>`. Only loopback addresses work. A port that devlanes or a lane already uses is an error. Required.",
227
+ "type": [
228
+ "string",
229
+ "null"
230
+ ]
231
+ },
232
+ "hidden": {
233
+ "description": "Keep the entry away from machines connected with `devlanes remote connect`. They never see, mirror or reach it. This machine still routes its hostnames. Defaults to false.",
234
+ "examples": [
235
+ false,
236
+ true
237
+ ],
238
+ "markdownDescription": "Keep the entry away from machines connected with `devlanes remote connect`. They never see, mirror or reach it. This machine still routes its hostnames. Defaults to false.",
239
+ "type": [
240
+ "boolean",
241
+ "null"
242
+ ]
243
+ },
244
+ "hosts": {
245
+ "anyOf": [
246
+ {
247
+ "$ref": "#/$defs/ExternalHosts",
248
+ "description": "",
249
+ "examples": [],
250
+ "markdownDescription": ""
251
+ },
252
+ {
253
+ "type": "null"
254
+ }
255
+ ],
256
+ "description": "Hostnames the devlanes HTTPS proxy routes to the port. One entry or a list. An entry is a hostname, or a mapping with `host` and optional `fallback` and `host_header`. Expressions can use `lane`, `project`, `infra` and `env`. Put the names under `${{ lane.domain }}` so each lane gets its own. The first host without a wildcard becomes the unit's URL.",
257
+ "examples": [
258
+ "pgadmin.${{ lane.domain }}",
259
+ [
260
+ "docs.${{ lane.domain }}"
261
+ ]
262
+ ],
263
+ "markdownDescription": "Hostnames the devlanes HTTPS proxy routes to the port. One entry or a list. An entry is a hostname, or a mapping with `host` and optional `fallback` and `host_header`. Expressions can use `lane`, `project`, `infra` and `env`. Put the names under `${{ lane.domain }}` so each lane gets its own. The first host without a wildcard becomes the unit's URL."
264
+ }
265
+ },
266
+ "type": "object"
267
+ },
268
+ "ExternalHost": {
269
+ "anyOf": [
270
+ {
271
+ "$ref": "#/$defs/Templated_string",
272
+ "description": "",
273
+ "examples": [],
274
+ "markdownDescription": ""
275
+ },
276
+ {
277
+ "$ref": "#/$defs/ExternalHostRoute",
278
+ "description": "",
279
+ "examples": [],
280
+ "markdownDescription": ""
281
+ }
282
+ ],
283
+ "description": "HTTPS hostname of an `infra.external` entry: a plain hostname, or a mapping with `host` plus `fallback` or `host_header`. The entry has one port, so a route names none.",
284
+ "examples": [
285
+ "pgadmin.${{ lane.domain }}",
286
+ {
287
+ "fallback": true,
288
+ "host": "*.pgadmin.${{ lane.domain }}"
289
+ }
290
+ ],
291
+ "markdownDescription": "HTTPS hostname of an `infra.external` entry: a plain hostname, or a mapping with `host` plus `fallback` or `host_header`. The entry has one port, so a route names none."
292
+ },
293
+ "ExternalHostRoute": {
294
+ "additionalProperties": false,
295
+ "description": "Hostname route of an `infra.external` entry with options: catch-all behaviour or a rewritten Host header.",
296
+ "examples": [
297
+ {
298
+ "fallback": true,
299
+ "host": "*.pgadmin.${{ lane.domain }}"
300
+ },
301
+ {
302
+ "host": "pgadmin.${{ lane.domain }}",
303
+ "host_header": "upstream"
304
+ }
305
+ ],
306
+ "markdownDescription": "Hostname route of an `infra.external` entry with options: catch-all behaviour or a rewritten Host header.",
307
+ "properties": {
308
+ "fallback": {
309
+ "anyOf": [
310
+ {
311
+ "$ref": "#/$defs/Templated_boolean",
312
+ "description": "",
313
+ "examples": [],
314
+ "markdownDescription": ""
315
+ },
316
+ {
317
+ "type": "null"
318
+ }
319
+ ],
320
+ "description": "Make this route a catch-all: it is used only when no other route, exact or wildcard, matches the requested hostname. Defaults to false.",
321
+ "examples": [
322
+ true,
323
+ false
324
+ ],
325
+ "markdownDescription": "Make this route a catch-all: it is used only when no other route, exact or wildcard, matches the requested hostname. Defaults to false."
326
+ },
327
+ "host": {
328
+ "$ref": "#/$defs/Templated_string",
329
+ "description": "Hostname to route, evaluated for each lane. A leading `*.` makes a wildcard that matches any depth below it but not the name itself. Quote it in YAML. Labels hold letters, digits and inner hyphens. Case and a trailing dot are ignored.",
330
+ "examples": [
331
+ "pgadmin.${{ lane.domain }}",
332
+ "*.pgadmin.${{ lane.domain }}"
333
+ ],
334
+ "markdownDescription": "Hostname to route, evaluated for each lane. A leading `*.` makes a wildcard that matches any depth below it but not the name itself. Quote it in YAML. Labels hold letters, digits and inner hyphens. Case and a trailing dot are ignored."
335
+ },
336
+ "host_header": {
337
+ "anyOf": [
338
+ {
339
+ "$ref": "#/$defs/HostHeader",
340
+ "description": "",
341
+ "examples": [],
342
+ "markdownDescription": ""
343
+ },
344
+ {
345
+ "type": "null"
346
+ }
347
+ ],
348
+ "description": "Host header the server receives. Defaults to `preserve`, the hostname the browser asked for. `upstream` sends the address devlanes connects to, such as `127.0.0.1:5050`, for servers that only accept their own address.",
349
+ "examples": [
350
+ "preserve",
351
+ "upstream"
352
+ ],
353
+ "markdownDescription": "Host header the server receives. Defaults to `preserve`, the hostname the browser asked for. `upstream` sends the address devlanes connects to, such as `127.0.0.1:5050`, for servers that only accept their own address."
354
+ }
355
+ },
356
+ "required": [
357
+ "host"
358
+ ],
359
+ "type": "object"
360
+ },
361
+ "ExternalHosts": {
362
+ "anyOf": [
363
+ {
364
+ "$ref": "#/$defs/ExternalHost",
365
+ "description": "",
366
+ "examples": [],
367
+ "markdownDescription": ""
368
+ },
369
+ {
370
+ "items": {
371
+ "$ref": "#/$defs/ExternalHost",
372
+ "description": "HTTPS hostname of an `infra.external` entry: a plain hostname, or a mapping with `host` plus `fallback` or `host_header`. The entry has one port, so a route names none.",
373
+ "examples": [
374
+ "pgadmin.${{ lane.domain }}",
375
+ {
376
+ "fallback": true,
377
+ "host": "*.pgadmin.${{ lane.domain }}"
378
+ }
379
+ ],
380
+ "markdownDescription": "HTTPS hostname of an `infra.external` entry: a plain hostname, or a mapping with `host` plus `fallback` or `host_header`. The entry has one port, so a route names none."
381
+ },
382
+ "type": "array"
383
+ }
384
+ ],
385
+ "description": "HTTPS hostnames the devlanes proxy routes to an `infra.external` port: one hostname or route mapping, or a list of them.",
386
+ "examples": [
387
+ "pgadmin.${{ lane.domain }}",
388
+ [
389
+ "pgadmin.${{ lane.domain }}",
390
+ {
391
+ "fallback": true,
392
+ "host": "*.pgadmin.${{ lane.domain }}"
393
+ }
394
+ ]
395
+ ],
396
+ "markdownDescription": "HTTPS hostnames the devlanes proxy routes to an `infra.external` port: one hostname or route mapping, or a list of them."
397
+ },
205
398
  "HostConfig": {
206
399
  "anyOf": [
207
400
  {
@@ -741,22 +934,51 @@
741
934
  "null"
742
935
  ]
743
936
  },
937
+ "external": {
938
+ "additionalProperties": {
939
+ "$ref": "#/$defs/ExternalConfig",
940
+ "description": "A server you run yourself on a loopback port. Every lane of the project lists it, the proxy routes its hostnames to the port, and machines connected with `devlanes remote connect` mirror it while a lane of the project runs. The port is the same in every lane.",
941
+ "examples": [
942
+ {
943
+ "address": "127.0.0.1:5050",
944
+ "hosts": "pgadmin.${{ lane.domain }}"
945
+ },
946
+ {
947
+ "address": "[::1]:8000",
948
+ "hidden": true
949
+ }
950
+ ],
951
+ "markdownDescription": "A server you run yourself on a loopback port. Every lane of the project lists it, the proxy routes its hostnames to the port, and machines connected with `devlanes remote connect` mirror it while a lane of the project runs. The port is the same in every lane."
952
+ },
953
+ "default": {},
954
+ "description": "Servers you run yourself on a loopback port, such as pgAdmin, keyed by name. Every lane lists them, the proxy routes their hostnames, and machines connected with `devlanes remote connect` mirror them while a lane of the project runs. devlanes never starts or checks them. Put personal ones in `devlanes.local.yaml`.",
955
+ "examples": [
956
+ {
957
+ "pgadmin": {
958
+ "address": "127.0.0.1:5050",
959
+ "hosts": "pgadmin.${{ lane.domain }}"
960
+ }
961
+ }
962
+ ],
963
+ "markdownDescription": "Servers you run yourself on a loopback port, such as pgAdmin, keyed by name. Every lane lists them, the proxy routes their hostnames, and machines connected with `devlanes remote connect` mirror them while a lane of the project runs. devlanes never starts or checks them. Put personal ones in `devlanes.local.yaml`.",
964
+ "type": "object"
965
+ },
744
966
  "hidden": {
745
- "description": "Containers whose ports are not mirrored to machines connected with `devlanes remote connect`.",
967
+ "description": "Containers that machines connected with `devlanes remote connect` never see, mirror or reach.",
746
968
  "examples": [
747
969
  [
748
970
  "postgres"
749
971
  ]
750
972
  ],
751
973
  "items": {
752
- "description": "Containers whose ports are not mirrored to machines connected with `devlanes remote connect`.",
974
+ "description": "Containers that machines connected with `devlanes remote connect` never see, mirror or reach.",
753
975
  "examples": [
754
976
  "postgres"
755
977
  ],
756
- "markdownDescription": "Containers whose ports are not mirrored to machines connected with `devlanes remote connect`.",
978
+ "markdownDescription": "Containers that machines connected with `devlanes remote connect` never see, mirror or reach.",
757
979
  "type": "string"
758
980
  },
759
- "markdownDescription": "Containers whose ports are not mirrored to machines connected with `devlanes remote connect`.",
981
+ "markdownDescription": "Containers that machines connected with `devlanes remote connect` never see, mirror or reach.",
760
982
  "type": [
761
983
  "array",
762
984
  "null"
@@ -1020,12 +1242,12 @@
1020
1242
  ]
1021
1243
  },
1022
1244
  "isolate_registry": {
1023
- "description": "Points `WRANGLER_REGISTRY_PATH` at `wrangler-registry` in the lane's data folder (`${{ lane.data_path }}`), so service bindings resolve to workers of the same lane instead of same-named workers in another lane, also when two lanes run from one folder. Set `false` to drop the variable for this service, which then uses Wrangler's shared default registry. Default: `true`.",
1245
+ "description": "Points `WRANGLER_REGISTRY_PATH`, `CLOUDFLARE_DEV_REGISTRY_PATH` and `MINIFLARE_REGISTRY_PATH` at `wrangler-registry` in the lane's data folder (`${{ lane.data_path }}`), so service bindings resolve to workers of the same lane instead of same-named workers in another lane, also when two lanes run from one folder. Set `false` to drop these variables for this service, which then uses Wrangler's shared default registry. Default: `true`.",
1024
1246
  "examples": [
1025
1247
  true,
1026
1248
  false
1027
1249
  ],
1028
- "markdownDescription": "Points `WRANGLER_REGISTRY_PATH` at `wrangler-registry` in the lane's data folder (`${{ lane.data_path }}`), so service bindings resolve to workers of the same lane instead of same-named workers in another lane, also when two lanes run from one folder. Set `false` to drop the variable for this service, which then uses Wrangler's shared default registry. Default: `true`.",
1250
+ "markdownDescription": "Points `WRANGLER_REGISTRY_PATH`, `CLOUDFLARE_DEV_REGISTRY_PATH` and `MINIFLARE_REGISTRY_PATH` at `wrangler-registry` in the lane's data folder (`${{ lane.data_path }}`), so service bindings resolve to workers of the same lane instead of same-named workers in another lane, also when two lanes run from one folder. Set `false` to drop these variables for this service, which then uses Wrangler's shared default registry. Default: `true`.",
1029
1251
  "type": [
1030
1252
  "boolean",
1031
1253
  "null"
@@ -1250,11 +1472,11 @@
1250
1472
  "markdownDescription": "What devlanes does when a worktree gets its lane: only reserve it, also set it up, or also start it. Defaults to `register`. A worktree gets a lane the first time devlanes runs in it or `devlanes lane new` creates it, not merely because it exists."
1251
1473
  },
1252
1474
  "primary": {
1253
- "description": "Branch whose worktree is lane 0, the main lane (`lanes.main` in expressions) and the only worktree that gets a lane by itself. Defaults to the remote's default branch, else `main` or `master`.",
1475
+ "description": "Branch whose worktree is lane 0, the main lane (`lanes.main` in expressions) and the only worktree that gets a lane by itself. Defaults to the remote's default branch, else `main` or `master`. In CI (a variable such as `CI` or `GITHUB_ACTIONS` is set) the checkout takes lane 0 on any branch when lane 0 is free.",
1254
1476
  "examples": [
1255
1477
  "main"
1256
1478
  ],
1257
- "markdownDescription": "Branch whose worktree is lane 0, the main lane (`lanes.main` in expressions) and the only worktree that gets a lane by itself. Defaults to the remote's default branch, else `main` or `master`.",
1479
+ "markdownDescription": "Branch whose worktree is lane 0, the main lane (`lanes.main` in expressions) and the only worktree that gets a lane by itself. Defaults to the remote's default branch, else `main` or `master`. In CI (a variable such as `CI` or `GITHUB_ACTIONS` is set) the checkout takes lane 0 on any branch when lane 0 is free.",
1258
1480
  "type": [
1259
1481
  "string",
1260
1482
  "null"
@@ -1955,12 +2177,12 @@
1955
2177
  "type": "null"
1956
2178
  }
1957
2179
  ],
1958
- "description": "Keep this service's ports and hosts off machines connected with `devlanes remote connect`: they are not mirrored there and cannot be reached from there. The service still runs and works on this machine. Defaults to false.",
2180
+ "description": "Keep this service away from machines connected with `devlanes remote connect`. They never see, mirror or reach it, and do not get its `sync` folders. It still runs on this machine. Defaults to false.",
1959
2181
  "examples": [
1960
2182
  false,
1961
2183
  true
1962
2184
  ],
1963
- "markdownDescription": "Keep this service's ports and hosts off machines connected with `devlanes remote connect`: they are not mirrored there and cannot be reached from there. The service still runs and works on this machine. Defaults to false."
2185
+ "markdownDescription": "Keep this service away from machines connected with `devlanes remote connect`. They never see, mirror or reach it, and do not get its `sync` folders. It still runs on this machine. Defaults to false."
1964
2186
  },
1965
2187
  "hosts": {
1966
2188
  "anyOf": [
@@ -2033,15 +2255,16 @@
2033
2255
  "markdownDescription": "Options for `preset: next`, which adds `--port <self.port> --hostname 127.0.0.1` to the `next dev` command. Without the hostname flag Next listens on `0.0.0.0` instead of loopback."
2034
2256
  },
2035
2257
  "platform": {
2036
- "description": "Runtime of the service: `node`, `bun`, `deno`, `python` or `rust`. It decides which variables devlanes adds, such as the devlanes CA (`NODE_EXTRA_CA_CERTS`, `SSL_CERT_FILE`) and color settings. Detected from the `run_script` file or the working directory when omitted; set it only when detection is wrong.",
2258
+ "description": "Runtime of the service: `node`, `bun`, `deno`, `python` or `rust`. It decides which variables devlanes adds, such as the devlanes CA (`NODE_EXTRA_CA_CERTS`, `SSL_CERT_FILE`) and color settings. Detected from the `run_script` file or the working directory when omitted; set it only when detection is wrong. `none` skips detection and adds no platform variables.",
2037
2259
  "examples": [
2038
2260
  "node",
2039
2261
  "bun",
2040
2262
  "deno",
2041
2263
  "python",
2042
- "rust"
2264
+ "rust",
2265
+ "none"
2043
2266
  ],
2044
- "markdownDescription": "Runtime of the service: `node`, `bun`, `deno`, `python` or `rust`. It decides which variables devlanes adds, such as the devlanes CA (`NODE_EXTRA_CA_CERTS`, `SSL_CERT_FILE`) and color settings. Detected from the `run_script` file or the working directory when omitted; set it only when detection is wrong.",
2267
+ "markdownDescription": "Runtime of the service: `node`, `bun`, `deno`, `python` or `rust`. It decides which variables devlanes adds, such as the devlanes CA (`NODE_EXTRA_CA_CERTS`, `SSL_CERT_FILE`) and color settings. Detected from the `run_script` file or the working directory when omitted; set it only when detection is wrong. `none` skips detection and adds no platform variables.",
2045
2268
  "type": [
2046
2269
  "string",
2047
2270
  "null"
@@ -3037,6 +3260,7 @@
3037
3260
  "containers": {},
3038
3261
  "env": {},
3039
3262
  "exclude": null,
3263
+ "external": {},
3040
3264
  "hidden": null,
3041
3265
  "hosts": {},
3042
3266
  "per_lane": null,
package/user-schema.json CHANGED
@@ -77,12 +77,12 @@
77
77
  "properties": {
78
78
  "exit_when_idle": {
79
79
  "default": true,
80
- "description": "Stop the daemon about 30 seconds after the last TUI closes when no service, task or start is running; the next devlanes command starts it again. Containers keep running either way. Defaults to true. Only a daemon a command started on demand exits; one installed with `devlanes daemon install` keeps running.",
80
+ "description": "Stop the daemon about 30 seconds after the last TUI, or command that shows progress, closes, once nothing runs or starts, no box or client is connected or waiting to reconnect, and no pairing code is outstanding. A daemon that nothing ever watched this way, such as one only scripts or agents used, waits about 5 minutes instead. The next devlanes command starts it again. Containers keep running either way, but their hostnames answer only while the daemon runs. Defaults to true. Only a daemon a command started on demand exits. One installed with `devlanes daemon install` keeps running.",
81
81
  "examples": [
82
82
  true,
83
83
  false
84
84
  ],
85
- "markdownDescription": "Stop the daemon about 30 seconds after the last TUI closes when no service, task or start is running; the next devlanes command starts it again. Containers keep running either way. Defaults to true. Only a daemon a command started on demand exits; one installed with `devlanes daemon install` keeps running.",
85
+ "markdownDescription": "Stop the daemon about 30 seconds after the last TUI, or command that shows progress, closes, once nothing runs or starts, no box or client is connected or waiting to reconnect, and no pairing code is outstanding. A daemon that nothing ever watched this way, such as one only scripts or agents used, waits about 5 minutes instead. The next devlanes command starts it again. Containers keep running either way, but their hostnames answer only while the daemon runs. Defaults to true. Only a daemon a command started on demand exits. One installed with `devlanes daemon install` keeps running.",
86
86
  "type": "boolean"
87
87
  }
88
88
  },
@@ -130,12 +130,12 @@
130
130
  "remote_hosts_retention": {
131
131
  "$ref": "#/$defs/ConfigDuration",
132
132
  "default": "7776000000ms",
133
- "description": "How long a remote box stays listed by `devlanes remote ls` after its last successful connection; defaults to `90d` and must be longer than `0s`. A record without a connection time is never deleted by age, and `state.max_size` can delete records sooner.",
133
+ "description": "How long a remote box stays listed by `devlanes remote ls` after its last successful connection; defaults to `90d` and must be longer than `0s`. A record without a connection time is never deleted by age, and `state.max_size` can delete records sooner. A box connected with `devlanes remote connect` and not disconnected since is never deleted, so the daemon can connect it again after a restart.",
134
134
  "examples": [
135
135
  "90d",
136
136
  "180d"
137
137
  ],
138
- "markdownDescription": "How long a remote box stays listed by `devlanes remote ls` after its last successful connection; defaults to `90d` and must be longer than `0s`. A record without a connection time is never deleted by age, and `state.max_size` can delete records sooner."
138
+ "markdownDescription": "How long a remote box stays listed by `devlanes remote ls` after its last successful connection; defaults to `90d` and must be longer than `0s`. A record without a connection time is never deleted by age, and `state.max_size` can delete records sooner. A box connected with `devlanes remote connect` and not disconnected since is never deleted, so the daemon can connect it again after a restart."
139
139
  },
140
140
  "retention": {
141
141
  "$ref": "#/$defs/ConfigDuration",
@@ -456,6 +456,201 @@
456
456
  },
457
457
  "type": "object"
458
458
  },
459
+ "RemoteBox": {
460
+ "additionalProperties": false,
461
+ "description": "A box that `devlanes remote connect <name>` reaches by running a command. The command must run `devlanes tunnel --stdio` in the box.",
462
+ "examples": [
463
+ {
464
+ "command": [
465
+ "docker",
466
+ "exec",
467
+ "-i",
468
+ "acme",
469
+ "devlanes",
470
+ "tunnel",
471
+ "--stdio"
472
+ ]
473
+ },
474
+ {
475
+ "command": [
476
+ "wsl.exe",
477
+ "-d",
478
+ "Ubuntu",
479
+ "devlanes",
480
+ "tunnel",
481
+ "--stdio"
482
+ ]
483
+ }
484
+ ],
485
+ "markdownDescription": "A box that `devlanes remote connect <name>` reaches by running a command. The command must run `devlanes tunnel --stdio` in the box.",
486
+ "properties": {
487
+ "command": {
488
+ "description": "The program and its arguments as a list, one item per argument. No shell runs it. It must run `devlanes tunnel --stdio` in the box with its input and output passed through and no terminal, so use `docker exec -i`, not `-it`. It runs again for every reconnect and cannot ask for input, so sign in to its tool first.",
489
+ "examples": [
490
+ [
491
+ "docker",
492
+ "exec",
493
+ "-i",
494
+ "acme",
495
+ "devlanes",
496
+ "tunnel",
497
+ "--stdio"
498
+ ],
499
+ [
500
+ "kubectl",
501
+ "exec",
502
+ "-i",
503
+ "acme-0",
504
+ "--",
505
+ "devlanes",
506
+ "tunnel",
507
+ "--stdio"
508
+ ]
509
+ ],
510
+ "items": {
511
+ "description": "The program and its arguments as a list, one item per argument. No shell runs it. It must run `devlanes tunnel --stdio` in the box with its input and output passed through and no terminal, so use `docker exec -i`, not `-it`. It runs again for every reconnect and cannot ask for input, so sign in to its tool first.",
512
+ "examples": [
513
+ "docker",
514
+ "exec",
515
+ "-i",
516
+ "acme",
517
+ "devlanes",
518
+ "tunnel",
519
+ "--stdio",
520
+ "kubectl",
521
+ "exec",
522
+ "-i",
523
+ "acme-0",
524
+ "--",
525
+ "devlanes",
526
+ "tunnel",
527
+ "--stdio"
528
+ ],
529
+ "markdownDescription": "The program and its arguments as a list, one item per argument. No shell runs it. It must run `devlanes tunnel --stdio` in the box with its input and output passed through and no terminal, so use `docker exec -i`, not `-it`. It runs again for every reconnect and cannot ask for input, so sign in to its tool first.",
530
+ "type": "string"
531
+ },
532
+ "markdownDescription": "The program and its arguments as a list, one item per argument. No shell runs it. It must run `devlanes tunnel --stdio` in the box with its input and output passed through and no terminal, so use `docker exec -i`, not `-it`. It runs again for every reconnect and cannot ask for input, so sign in to its tool first.",
533
+ "type": "array"
534
+ }
535
+ },
536
+ "required": [
537
+ "command"
538
+ ],
539
+ "type": "object"
540
+ },
541
+ "RemoteConfig": {
542
+ "additionalProperties": false,
543
+ "description": "Settings for `devlanes remote connect`: boxes reached by a command, and how this machine serves clients when it is a box.",
544
+ "examples": [
545
+ {
546
+ "allow_connections": false
547
+ },
548
+ {
549
+ "start_daemon": false
550
+ },
551
+ {
552
+ "require_pairing": false
553
+ },
554
+ {
555
+ "boxes": {
556
+ "acme": {
557
+ "command": [
558
+ "docker",
559
+ "exec",
560
+ "-i",
561
+ "acme",
562
+ "devlanes",
563
+ "tunnel",
564
+ "--stdio"
565
+ ]
566
+ }
567
+ }
568
+ }
569
+ ],
570
+ "markdownDescription": "Settings for `devlanes remote connect`: boxes reached by a command, and how this machine serves clients when it is a box.",
571
+ "properties": {
572
+ "allow_connections": {
573
+ "default": true,
574
+ "description": "Let other machines connect to this one with `devlanes remote connect`. Defaults to true. When false, every client is turned away and `devlanes daemon pair` gives no codes. Connecting from this machine to a box still works. Clients already connected stay until they disconnect. An invalid value counts as false.",
575
+ "examples": [
576
+ true,
577
+ false
578
+ ],
579
+ "markdownDescription": "Let other machines connect to this one with `devlanes remote connect`. Defaults to true. When false, every client is turned away and `devlanes daemon pair` gives no codes. Connecting from this machine to a box still works. Clients already connected stay until they disconnect. An invalid value counts as false.",
580
+ "type": "boolean"
581
+ },
582
+ "boxes": {
583
+ "additionalProperties": {
584
+ "$ref": "#/$defs/RemoteBox",
585
+ "description": "A box that `devlanes remote connect <name>` reaches by running a command. The command must run `devlanes tunnel --stdio` in the box.",
586
+ "examples": [
587
+ {
588
+ "command": [
589
+ "docker",
590
+ "exec",
591
+ "-i",
592
+ "acme",
593
+ "devlanes",
594
+ "tunnel",
595
+ "--stdio"
596
+ ]
597
+ },
598
+ {
599
+ "command": [
600
+ "wsl.exe",
601
+ "-d",
602
+ "Ubuntu",
603
+ "devlanes",
604
+ "tunnel",
605
+ "--stdio"
606
+ ]
607
+ }
608
+ ],
609
+ "markdownDescription": "A box that `devlanes remote connect <name>` reaches by running a command. The command must run `devlanes tunnel --stdio` in the box."
610
+ },
611
+ "default": {},
612
+ "description": "Boxes that `devlanes remote connect <name>` reaches by running a command instead of SSH, keyed by that name. Use it for a container, a WSL distribution or a codespace. Names not listed here are SSH destinations. Changes apply at the next `remote connect`.",
613
+ "examples": [
614
+ {
615
+ "acme": {
616
+ "command": [
617
+ "docker",
618
+ "exec",
619
+ "-i",
620
+ "acme",
621
+ "devlanes",
622
+ "tunnel",
623
+ "--stdio"
624
+ ]
625
+ }
626
+ }
627
+ ],
628
+ "markdownDescription": "Boxes that `devlanes remote connect <name>` reaches by running a command instead of SSH, keyed by that name. Use it for a container, a WSL distribution or a codespace. Names not listed here are SSH destinations. Changes apply at the next `remote connect`.",
629
+ "type": "object"
630
+ },
631
+ "require_pairing": {
632
+ "default": true,
633
+ "description": "Serve only clients paired with this machine. Defaults to true. A client's first connection needs a one-time code from `devlanes daemon pair`, and `devlanes daemon revoke` removes a pairing. Set false to serve every client that reaches this machine over SSH or its command. An invalid value counts as true.",
634
+ "examples": [
635
+ true,
636
+ false
637
+ ],
638
+ "markdownDescription": "Serve only clients paired with this machine. Defaults to true. A client's first connection needs a one-time code from `devlanes daemon pair`, and `devlanes daemon revoke` removes a pairing. Set false to serve every client that reaches this machine over SSH or its command. An invalid value counts as true.",
639
+ "type": "boolean"
640
+ },
641
+ "start_daemon": {
642
+ "default": true,
643
+ "description": "Start the devlanes daemon here when a client connects and it is not running. Defaults to true. When false, a client keeps retrying until you run `devlanes daemon start` here. An invalid value counts as false.",
644
+ "examples": [
645
+ true,
646
+ false
647
+ ],
648
+ "markdownDescription": "Start the devlanes daemon here when a client connects and it is not running. Defaults to true. When false, a client keeps retrying until you run `devlanes daemon start` here. An invalid value counts as false.",
649
+ "type": "boolean"
650
+ }
651
+ },
652
+ "type": "object"
653
+ },
459
654
  "Resolver": {
460
655
  "description": "Strategy that makes lane hostnames resolve to this machine.",
461
656
  "enum": [
@@ -1166,13 +1361,13 @@
1166
1361
  "default": {
1167
1362
  "exit_when_idle": true
1168
1363
  },
1169
- "description": "The daemon's lifetime: whether it stops on its own once the last TUI closes and nothing runs.",
1364
+ "description": "The daemon's lifetime: whether it stops on its own once nothing runs and no TUI is open.",
1170
1365
  "examples": [
1171
1366
  {
1172
1367
  "exit_when_idle": false
1173
1368
  }
1174
1369
  ],
1175
- "markdownDescription": "The daemon's lifetime: whether it stops on its own once the last TUI closes and nothing runs."
1370
+ "markdownDescription": "The daemon's lifetime: whether it stops on its own once nothing runs and no TUI is open."
1176
1371
  },
1177
1372
  "history": {
1178
1373
  "$ref": "#/$defs/HistoryConfig",
@@ -1298,6 +1493,43 @@
1298
1493
  ],
1299
1494
  "markdownDescription": "Ports of the daemon's HTTP/HTTPS proxy, which serves every `hosts` entry, and whether other devices on the network may connect to it."
1300
1495
  },
1496
+ "remote": {
1497
+ "$ref": "#/$defs/RemoteConfig",
1498
+ "default": {
1499
+ "allow_connections": true,
1500
+ "boxes": {},
1501
+ "require_pairing": true,
1502
+ "start_daemon": true
1503
+ },
1504
+ "description": "Settings for `devlanes remote connect`: boxes reached by a command, and how this machine serves clients when it is a box.",
1505
+ "examples": [
1506
+ {
1507
+ "allow_connections": false
1508
+ },
1509
+ {
1510
+ "start_daemon": false
1511
+ },
1512
+ {
1513
+ "require_pairing": false
1514
+ },
1515
+ {
1516
+ "boxes": {
1517
+ "acme": {
1518
+ "command": [
1519
+ "docker",
1520
+ "exec",
1521
+ "-i",
1522
+ "acme",
1523
+ "devlanes",
1524
+ "tunnel",
1525
+ "--stdio"
1526
+ ]
1527
+ }
1528
+ }
1529
+ }
1530
+ ],
1531
+ "markdownDescription": "Settings for `devlanes remote connect`: boxes reached by a command, and how this machine serves clients when it is a box."
1532
+ },
1301
1533
  "start": {
1302
1534
  "$ref": "#/$defs/StartConfig",
1303
1535
  "default": {