@onkernel/cli 0.13.5 → 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.
Files changed (2) hide show
  1. package/README.md +100 -2
  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 --yes
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.13.5",
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.13.5_darwin_arm64.tar.gz",
38
- "url": "https://github.com/kernel/cli/releases/download/v0.13.5/kernel_0.13.5_darwin_arm64.tar.gz",
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": "54ad106b4c78d259131422e9d325b222b2568884597934a55eded38285327d47"
45
+ "digest": "97ac9fcd3b3b78deb9ad9495db79458c12b3532bf93b3c4fe2ba2658f8d4ac23"
46
46
  }
47
47
  },
48
48
  "darwin-x64": {
49
- "name": "kernel_0.13.5_darwin_amd64.tar.gz",
50
- "url": "https://github.com/kernel/cli/releases/download/v0.13.5/kernel_0.13.5_darwin_amd64.tar.gz",
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": "065622b9ab57a8c9ff87e30cf23e609eb391867016e6b055b9a16679fd825151"
57
+ "digest": "6a85caa4e4642842c7c72dd4de2b4c12ed4de0506e4c9abcaf638a39e1b5c492"
58
58
  }
59
59
  },
60
60
  "linux-arm64": {
61
- "name": "kernel_0.13.5_linux_arm64.tar.gz",
62
- "url": "https://github.com/kernel/cli/releases/download/v0.13.5/kernel_0.13.5_linux_arm64.tar.gz",
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": "b2024d20cb09bcac5181dfdb94e07ee3c4d7710bea7e1e401fc97fd16d22e242"
69
+ "digest": "3f9b05618d0da3f34f70cab42f9b48c70113eda064bee212ebac4cf4f3b632c9"
70
70
  }
71
71
  },
72
72
  "linux-x64": {
73
- "name": "kernel_0.13.5_linux_amd64.tar.gz",
74
- "url": "https://github.com/kernel/cli/releases/download/v0.13.5/kernel_0.13.5_linux_amd64.tar.gz",
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": "6240b10abd4e3e94d82731933cbfbf452da3ee1c1496d97da8660e487d2151c1"
81
+ "digest": "e91ad584aac67cbc2c465bcddfd359dfb31f94fd0bf5ffd38ba930a4a74632fe"
82
82
  }
83
83
  },
84
84
  "win32-arm64": {
85
- "name": "kernel_0.13.5_windows_arm64.tar.gz",
86
- "url": "https://github.com/kernel/cli/releases/download/v0.13.5/kernel_0.13.5_windows_arm64.tar.gz",
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": "7b8d369af249b711bc23a16979e59076271deed6b005ff4ebdf2721205afd2e5"
93
+ "digest": "b1e8a01dd4c7f17dff64d6f74ec697a893054a2e0b188db788706c025e8cd4aa"
94
94
  }
95
95
  },
96
96
  "win32-x64": {
97
- "name": "kernel_0.13.5_windows_amd64.tar.gz",
98
- "url": "https://github.com/kernel/cli/releases/download/v0.13.5/kernel_0.13.5_windows_amd64.tar.gz",
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": "6de22f0bb8013bdf96a6a47b96437c2a46321000edf93d85d48ab71f0ad253d2"
105
+ "digest": "c9e1c74d49f1e676d7aee4323c0d69b43474a3b4f21ca1d177f5855e4e6f03d7"
106
106
  }
107
107
  }
108
108
  }