@onkernel/cli 0.13.4 → 0.14.0
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/README.md +100 -2
- package/package.json +19 -19
package/README.md
CHANGED
|
@@ -213,7 +213,6 @@ Commands with JSON output support:
|
|
|
213
213
|
- `--output json`, `-o json` - Output raw JSON object
|
|
214
214
|
- _Note: When a pool is specified, omit other session configuration flags—pool settings determine profile, proxy, viewport, etc._
|
|
215
215
|
- `kernel browsers delete <id>` - Delete a browser
|
|
216
|
-
- `-y, --yes` - Skip confirmation prompt
|
|
217
216
|
- `kernel browsers view <id>` - Get live view URL for a browser
|
|
218
217
|
- `--output json`, `-o json` - Output JSON with liveViewUrl
|
|
219
218
|
- `kernel browsers get <id>` - Get detailed browser session info
|
|
@@ -428,6 +427,76 @@ Commands with JSON output support:
|
|
|
428
427
|
- `kernel proxies delete <id>` - Delete a proxy configuration
|
|
429
428
|
- `-y, --yes` - Skip confirmation prompt
|
|
430
429
|
|
|
430
|
+
### Agent Auth
|
|
431
|
+
|
|
432
|
+
Automated authentication for web services. The `run` command orchestrates the full auth flow automatically.
|
|
433
|
+
|
|
434
|
+
- `kernel agents auth run` - Run a complete authentication flow
|
|
435
|
+
- `--domain <domain>` - Target domain for authentication (required)
|
|
436
|
+
- `--profile <name>` - Profile name to use/create (required)
|
|
437
|
+
- `--value <key=value>` - Field name=value pair (repeatable, e.g., `--value username=foo --value password=bar`)
|
|
438
|
+
- `--credential <name>` - Existing credential name to use
|
|
439
|
+
- `--save-credential-as <name>` - Save provided credentials under this name
|
|
440
|
+
- `--totp-secret <secret>` - Base32 TOTP secret for automatic 2FA
|
|
441
|
+
- `--proxy-id <id>` - Proxy ID to use
|
|
442
|
+
- `--login-url <url>` - Custom login page URL
|
|
443
|
+
- `--allowed-domain <domain>` - Additional allowed domains (repeatable)
|
|
444
|
+
- `--timeout <duration>` - Maximum time to wait for auth completion (default: 5m)
|
|
445
|
+
- `--open` - Open live view URL in browser when human intervention needed
|
|
446
|
+
- `--output json`, `-o json` - Output JSONL events
|
|
447
|
+
|
|
448
|
+
- `kernel agents auth create` - Create an auth agent
|
|
449
|
+
- `--domain <domain>` - Target domain for authentication (required)
|
|
450
|
+
- `--profile-name <name>` - Name of the profile to use (required)
|
|
451
|
+
- `--credential-name <name>` - Optional credential name to link
|
|
452
|
+
- `--login-url <url>` - Optional login page URL
|
|
453
|
+
- `--allowed-domain <domain>` - Additional allowed domains (repeatable)
|
|
454
|
+
- `--proxy-id <id>` - Optional proxy ID to use
|
|
455
|
+
- `--output json`, `-o json` - Output raw JSON object
|
|
456
|
+
|
|
457
|
+
- `kernel agents auth list` - List auth agents
|
|
458
|
+
- `--domain <domain>` - Filter by domain
|
|
459
|
+
- `--profile-name <name>` - Filter by profile name
|
|
460
|
+
- `--limit <n>` - Maximum number of results to return
|
|
461
|
+
- `--offset <n>` - Number of results to skip
|
|
462
|
+
- `--output json`, `-o json` - Output raw JSON array
|
|
463
|
+
|
|
464
|
+
- `kernel agents auth get <id>` - Get an auth agent by ID
|
|
465
|
+
- `--output json`, `-o json` - Output raw JSON object
|
|
466
|
+
|
|
467
|
+
- `kernel agents auth delete <id>` - Delete an auth agent
|
|
468
|
+
- `-y, --yes` - Skip confirmation prompt
|
|
469
|
+
|
|
470
|
+
### Credentials
|
|
471
|
+
|
|
472
|
+
- `kernel credentials create` - Create a new credential
|
|
473
|
+
- `--name <name>` - Unique name for the credential (required)
|
|
474
|
+
- `--domain <domain>` - Target domain (required)
|
|
475
|
+
- `--value <key=value>` - Field name=value pair (repeatable)
|
|
476
|
+
- `--sso-provider <provider>` - SSO provider (google, github, microsoft)
|
|
477
|
+
- `--totp-secret <secret>` - Base32-encoded TOTP secret for 2FA
|
|
478
|
+
- `--output json`, `-o json` - Output raw JSON object
|
|
479
|
+
|
|
480
|
+
- `kernel credentials list` - List credentials
|
|
481
|
+
- `--domain <domain>` - Filter by domain
|
|
482
|
+
- `--output json`, `-o json` - Output raw JSON array
|
|
483
|
+
|
|
484
|
+
- `kernel credentials get <id-or-name>` - Get a credential by ID or name
|
|
485
|
+
- `--output json`, `-o json` - Output raw JSON object
|
|
486
|
+
|
|
487
|
+
- `kernel credentials update <id-or-name>` - Update a credential
|
|
488
|
+
- `--name <name>` - New name
|
|
489
|
+
- `--value <key=value>` - Field values to update (repeatable)
|
|
490
|
+
- `--sso-provider <provider>` - SSO provider
|
|
491
|
+
- `--totp-secret <secret>` - TOTP secret
|
|
492
|
+
- `--output json`, `-o json` - Output raw JSON object
|
|
493
|
+
|
|
494
|
+
- `kernel credentials delete <id-or-name>` - Delete a credential
|
|
495
|
+
- `-y, --yes` - Skip confirmation prompt
|
|
496
|
+
|
|
497
|
+
- `kernel credentials totp-code <id-or-name>` - Get current TOTP code
|
|
498
|
+
- `--output json`, `-o json` - Output raw JSON object
|
|
499
|
+
|
|
431
500
|
## Examples
|
|
432
501
|
|
|
433
502
|
### Create a new app
|
|
@@ -519,7 +588,7 @@ kernel browsers create --kiosk
|
|
|
519
588
|
kernel browsers create --profile-name my-profile
|
|
520
589
|
|
|
521
590
|
# Delete a browser
|
|
522
|
-
kernel browsers delete browser123
|
|
591
|
+
kernel browsers delete browser123
|
|
523
592
|
|
|
524
593
|
# Get live view URL
|
|
525
594
|
kernel browsers view browser123
|
|
@@ -642,6 +711,35 @@ kernel proxies get prx_123
|
|
|
642
711
|
kernel proxies delete prx_123 --yes
|
|
643
712
|
```
|
|
644
713
|
|
|
714
|
+
### Agent auth
|
|
715
|
+
|
|
716
|
+
```bash
|
|
717
|
+
# Run a complete auth flow with inline credentials
|
|
718
|
+
kernel agents auth run --domain github.com --profile my-github \
|
|
719
|
+
--value username=myuser --value password=mypass
|
|
720
|
+
|
|
721
|
+
# Auth with TOTP for automatic 2FA handling
|
|
722
|
+
kernel agents auth run --domain github.com --profile my-github \
|
|
723
|
+
--value username=myuser --value password=mypass \
|
|
724
|
+
--totp-secret JBSWY3DPEHPK3PXP
|
|
725
|
+
|
|
726
|
+
# Save credentials for future re-auth
|
|
727
|
+
kernel agents auth run --domain github.com --profile my-github \
|
|
728
|
+
--value username=myuser --value password=mypass \
|
|
729
|
+
--save-credential-as github-creds
|
|
730
|
+
|
|
731
|
+
# Re-use existing saved credential
|
|
732
|
+
kernel agents auth run --domain github.com --profile my-github \
|
|
733
|
+
--credential github-creds
|
|
734
|
+
|
|
735
|
+
# Auto-open browser when human intervention is needed
|
|
736
|
+
kernel agents auth run --domain github.com --profile my-github \
|
|
737
|
+
--credential github-creds --open
|
|
738
|
+
|
|
739
|
+
# Use the authenticated profile with a browser
|
|
740
|
+
kernel browsers create --profile-name my-github
|
|
741
|
+
```
|
|
742
|
+
|
|
645
743
|
## Getting Help
|
|
646
744
|
|
|
647
745
|
- `kernel --help` - Show all available commands
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@onkernel/cli",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.14.0",
|
|
4
4
|
"description": "Kernel CLI",
|
|
5
5
|
"scripts": {
|
|
6
6
|
"postinstall": "node install.js",
|
|
@@ -34,75 +34,75 @@
|
|
|
34
34
|
},
|
|
35
35
|
"archives": {
|
|
36
36
|
"darwin-arm64": {
|
|
37
|
-
"name": "kernel_0.
|
|
38
|
-
"url": "https://github.com/kernel/cli/releases/download/v0.
|
|
37
|
+
"name": "kernel_0.14.0_darwin_arm64.tar.gz",
|
|
38
|
+
"url": "https://github.com/kernel/cli/releases/download/v0.14.0/kernel_0.14.0_darwin_arm64.tar.gz",
|
|
39
39
|
"bins": [
|
|
40
40
|
"kernel"
|
|
41
41
|
],
|
|
42
42
|
"format": "tar.gz",
|
|
43
43
|
"checksum": {
|
|
44
44
|
"algorithm": "sha256",
|
|
45
|
-
"digest": "
|
|
45
|
+
"digest": "97ac9fcd3b3b78deb9ad9495db79458c12b3532bf93b3c4fe2ba2658f8d4ac23"
|
|
46
46
|
}
|
|
47
47
|
},
|
|
48
48
|
"darwin-x64": {
|
|
49
|
-
"name": "kernel_0.
|
|
50
|
-
"url": "https://github.com/kernel/cli/releases/download/v0.
|
|
49
|
+
"name": "kernel_0.14.0_darwin_amd64.tar.gz",
|
|
50
|
+
"url": "https://github.com/kernel/cli/releases/download/v0.14.0/kernel_0.14.0_darwin_amd64.tar.gz",
|
|
51
51
|
"bins": [
|
|
52
52
|
"kernel"
|
|
53
53
|
],
|
|
54
54
|
"format": "tar.gz",
|
|
55
55
|
"checksum": {
|
|
56
56
|
"algorithm": "sha256",
|
|
57
|
-
"digest": "
|
|
57
|
+
"digest": "6a85caa4e4642842c7c72dd4de2b4c12ed4de0506e4c9abcaf638a39e1b5c492"
|
|
58
58
|
}
|
|
59
59
|
},
|
|
60
60
|
"linux-arm64": {
|
|
61
|
-
"name": "kernel_0.
|
|
62
|
-
"url": "https://github.com/kernel/cli/releases/download/v0.
|
|
61
|
+
"name": "kernel_0.14.0_linux_arm64.tar.gz",
|
|
62
|
+
"url": "https://github.com/kernel/cli/releases/download/v0.14.0/kernel_0.14.0_linux_arm64.tar.gz",
|
|
63
63
|
"bins": [
|
|
64
64
|
"kernel"
|
|
65
65
|
],
|
|
66
66
|
"format": "tar.gz",
|
|
67
67
|
"checksum": {
|
|
68
68
|
"algorithm": "sha256",
|
|
69
|
-
"digest": "
|
|
69
|
+
"digest": "3f9b05618d0da3f34f70cab42f9b48c70113eda064bee212ebac4cf4f3b632c9"
|
|
70
70
|
}
|
|
71
71
|
},
|
|
72
72
|
"linux-x64": {
|
|
73
|
-
"name": "kernel_0.
|
|
74
|
-
"url": "https://github.com/kernel/cli/releases/download/v0.
|
|
73
|
+
"name": "kernel_0.14.0_linux_amd64.tar.gz",
|
|
74
|
+
"url": "https://github.com/kernel/cli/releases/download/v0.14.0/kernel_0.14.0_linux_amd64.tar.gz",
|
|
75
75
|
"bins": [
|
|
76
76
|
"kernel"
|
|
77
77
|
],
|
|
78
78
|
"format": "tar.gz",
|
|
79
79
|
"checksum": {
|
|
80
80
|
"algorithm": "sha256",
|
|
81
|
-
"digest": "
|
|
81
|
+
"digest": "e91ad584aac67cbc2c465bcddfd359dfb31f94fd0bf5ffd38ba930a4a74632fe"
|
|
82
82
|
}
|
|
83
83
|
},
|
|
84
84
|
"win32-arm64": {
|
|
85
|
-
"name": "kernel_0.
|
|
86
|
-
"url": "https://github.com/kernel/cli/releases/download/v0.
|
|
85
|
+
"name": "kernel_0.14.0_windows_arm64.tar.gz",
|
|
86
|
+
"url": "https://github.com/kernel/cli/releases/download/v0.14.0/kernel_0.14.0_windows_arm64.tar.gz",
|
|
87
87
|
"bins": [
|
|
88
88
|
"kernel.exe"
|
|
89
89
|
],
|
|
90
90
|
"format": "tar.gz",
|
|
91
91
|
"checksum": {
|
|
92
92
|
"algorithm": "sha256",
|
|
93
|
-
"digest": "
|
|
93
|
+
"digest": "b1e8a01dd4c7f17dff64d6f74ec697a893054a2e0b188db788706c025e8cd4aa"
|
|
94
94
|
}
|
|
95
95
|
},
|
|
96
96
|
"win32-x64": {
|
|
97
|
-
"name": "kernel_0.
|
|
98
|
-
"url": "https://github.com/kernel/cli/releases/download/v0.
|
|
97
|
+
"name": "kernel_0.14.0_windows_amd64.tar.gz",
|
|
98
|
+
"url": "https://github.com/kernel/cli/releases/download/v0.14.0/kernel_0.14.0_windows_amd64.tar.gz",
|
|
99
99
|
"bins": [
|
|
100
100
|
"kernel.exe"
|
|
101
101
|
],
|
|
102
102
|
"format": "tar.gz",
|
|
103
103
|
"checksum": {
|
|
104
104
|
"algorithm": "sha256",
|
|
105
|
-
"digest": "
|
|
105
|
+
"digest": "c9e1c74d49f1e676d7aee4323c0d69b43474a3b4f21ca1d177f5855e4e6f03d7"
|
|
106
106
|
}
|
|
107
107
|
}
|
|
108
108
|
}
|