Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
35 commits
Select commit Hold shift + click to select a range
9cf2431
CLI: Update SDK to 0a28735 and add org entitlements command
kernel-internal[bot] Aug 17, 2026
dfdba4f
CLI: Update Go SDK to v0.92.0 (a156820)
kernel-internal[bot] Aug 17, 2026
6412b6f
Merge main into cli-coverage-update
kernel-internal[bot] Aug 18, 2026
8a7b363
CLI: Update Go SDK to 6e62bf5 and track managed-auth field reason
kernel-internal[bot] Aug 18, 2026
055d6a9
Merge main into cli-coverage-update
kernel-internal[bot] Aug 19, 2026
ca46838
CLI: Update Go SDK to 796d424 and bind canonical submits to interactions
kernel-internal[bot] Aug 19, 2026
31d2462
CLI: Update Go SDK to 467fea7
kernel-internal[bot] Aug 19, 2026
16880f4
CLI: Update Go SDK to v0.93.0 (0802326)
kernel-internal[bot] Aug 20, 2026
f9b126f
CLI: Update Go SDK to 9a36566 and cover the telemetry control/platfor…
kernel-internal[bot] Aug 21, 2026
063d7f5
CLI: Update Go SDK to c042837 and drop the telemetry control/platform…
kernel-internal[bot] Aug 21, 2026
f777871
Merge main into cli-coverage-update
kernel-internal[bot] Aug 24, 2026
484e19f
CLI: Update Go SDK to 5e48c58 and restore the telemetry control/platf…
kernel-internal[bot] Aug 24, 2026
76455e6
Merge main into cli-coverage-update
kernel-internal[bot] Aug 24, 2026
8b5a06b
CLI: Update Go SDK to 26309b6 and drop the telemetry control/platform…
kernel-internal[bot] Aug 24, 2026
c6c402b
CLI: Update Go SDK to 9de3679 (v0.94.0) and restore the telemetry con…
kernel-internal[bot] Aug 24, 2026
ee72f2d
CLI: Update Go SDK to c472a30
kernel-internal[bot] Aug 26, 2026
cb4630d
Merge main into cli-coverage-update
kernel-internal[bot] Aug 26, 2026
99b27bb
feat: update Go SDK to 46978e2 and add ap-southeast region
kernel-internal[bot] Aug 26, 2026
3ce0c81
chore: update Go SDK to v0.95.0 (0c36fa4)
kernel-internal[bot] Aug 26, 2026
992e0f8
Merge main into cli-coverage-update
kernel-internal[bot] Aug 26, 2026
11fa9ed
chore: update Go SDK to d348ffc and repair merge fallout
kernel-internal[bot] Aug 27, 2026
3ce899d
chore: update Go SDK to v0.96.0 (bb4371c)
kernel-internal[bot] Aug 27, 2026
69e922f
Merge main into cli-coverage-update
kernel-internal[bot] Aug 28, 2026
77bddae
chore: update Go SDK to 6e498fb (captcha task and challenge outcomes)
kernel-internal[bot] Aug 28, 2026
aa1b67c
chore: update Go SDK to 94c784a (managed auth reauth reasons)
kernel-internal[bot] Aug 31, 2026
bd99059
chore: update Go SDK to v0.97.0 (e9ee30b)
kernel-internal[bot] Aug 31, 2026
d21ec11
Merge main into cli-coverage-update
kernel-internal[bot] Sep 2, 2026
fc5ba82
chore: update Go SDK to ed434f7 and add browsers webmcp commands
kernel-internal[bot] Sep 2, 2026
36bd0eb
chore: update Go SDK to v0.98.0 (d02140d)
kernel-internal[bot] Sep 2, 2026
073992e
chore: update Go SDK to 7a377c7 and surface OTLP destination delivery…
kernel-internal[bot] Sep 3, 2026
2bc63e8
Merge main into cli-coverage-update
kernel-internal[bot] Sep 4, 2026
75eae00
chore: update Go SDK to 31c5fee and add vaults commands
kernel-internal[bot] Sep 4, 2026
c3ed6f1
chore: update Go SDK to v0.99.0 (b228059), test and document vaults
kernel-internal[bot] Sep 4, 2026
b4ac39e
chore: update Go SDK to 6ec0643 (vault provider errors, no test-mode …
kernel-internal[bot] Sep 4, 2026
669ea71
chore: pin Go SDK to tagged v0.100.0 (07e74ed)
kernel-internal[bot] Sep 4, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
67 changes: 67 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -223,6 +223,7 @@ Commands with JSON output support:
- `--proxy-mode direct|default` - Egress mode instead of a selected proxy: `direct` for no proxy regardless of stealth, `default` for the stealth-derived default (Kernel's stealth proxy with `--stealth`, direct egress otherwise). Omit all proxy flags to get the default.
- `--name <name>` - Optional unique name for the session (used to find it later by name; can be changed with `browsers update --name`)
- `--tag <KEY=VALUE>` - Set a tag on the session, repeatable; up to 50 pairs
- `--vault <id-or-name>` - Link a project-scoped vault to the session so it can use the vault's items (repeatable or comma-separated). Fixed once the session is created; `browsers get` lists the linked vaults.
- `--pool-id <id>` - Acquire a browser from the specified pool (mutually exclusive with --pool-name; ignores other session flags). `--name`/`--tag` still apply to the acquired session.
- `--pool-name <name>` - Acquire a browser from the pool name (mutually exclusive with --pool-id; ignores other session flags)
- `--telemetry=all` - Enable telemetry for all categories
Expand Down Expand Up @@ -511,6 +512,71 @@ Destinations are the OTLP/HTTP endpoints sessions export to, managed per project
- `--to <dir>` - Directory to extract the profile into (required)
- `--format <format>` - Archive format to request: `tar.zst` (compressed, default) or `tar` (decompressed server-side)

### Vaults

A vault is a named, project-scoped container for payment items. Vault names and
item keys are immutable, so `create` behaves as an upsert: creating with a name
or key that already exists returns what is there rather than failing. Link
vaults to a session with `kernel browsers create --vault <id-or-name>`.

- `kernel vaults list` - List vaults in the current project
- `--page <n>` - Page number, 1-based (default 1)
- `--per-page <n>` - Items per page (default 20)
- `--output json`, `-o json` - Output raw JSON array
- When more vaults are available, the CLI prints the exact command to fetch the next page
- `kernel vaults get <id-or-name>` - Get a vault by ID or name
- `--output json`, `-o json` - Output raw JSON object
- `kernel vaults create --name <name>` - Create or retrieve a vault by name
- `--name <name>` - Immutable vault name (required)
- `--output json`, `-o json` - Output raw JSON object
- `kernel vaults delete <id-or-name>` - Delete a vault; every item it holds is invalidated
- `-y, --yes` - Skip confirmation prompt

#### Vault Items

An item is either a wallet (an authorized funding source) or a card (a payment
credential minted from a wallet). Items advertise the operations valid in their
current state, so run `kernel vaults items get` and read `Available Operations`
before invoking one.

- `kernel vaults items list <vault-id-or-name>` - List a vault's items; secret values are never returned
- `--output json`, `-o json` - Output raw JSON array
- `kernel vaults items get <vault-id-or-name> <key>` - Get an item and the operations currently valid for it
- `--wait <seconds>` - Hold for up to this many seconds while the item is pending authorization or approval (max 60)
- `--expand <type>` - Request live provider data listed under `Available Expansions`, e.g. `payment_methods` (repeatable or comma-separated). Expanded data is fetched from the provider and is not persisted in the item.
- `--output json`, `-o json` - Output raw JSON object
- `kernel vaults items create <vault-id-or-name> <key> --type <wallet|card> --spec <json>` - Create or retrieve an item by key
- `--type wallet|card` - Item type (required)
- `--spec <json>` - Provider-specific spec as a JSON object, discriminated by its `provider` field. Amounts are integers in minor currency units (`1250` = $12.50).
- `--spec-file <path>` - Read the spec from a file (use `-` for stdin). Mutually exclusive with `--spec`.
- `--output json`, `-o json` - Output raw JSON object

Examples:

```bash
kernel vaults items create my-vault my-wallet --type wallet \
--spec '{"provider":"agentcard","user_id":"usr_123"}'

kernel vaults items create my-vault my-wallet --type wallet \
--spec '{"provider":"link","authorization":{"method":"oauth","client":{"type":"kernel_managed"}}}'

kernel vaults items create my-vault my-card --type card \
--spec '{"provider":"agentcard","wallet":"my-wallet","merchant":"Acme","amount":1250,"currency":"USD"}'
```

- `kernel vaults items update <vault-id-or-name> <key> --spec <json>` - Update a card item's spec before or between authorizations
- `--spec <json>` / `--spec-file <path>` - Full replacement card spec (only card items can be updated)
- `--output json`, `-o json` - Output raw JSON object
- `kernel vaults items perform-operation <vault-id-or-name> <key>` - Perform an operation the item advertises
- `--type <type>` - Operation to perform (default `authorize`). Operations may call an external provider and return the item's updated state.
- `--output json`, `-o json` - Output raw JSON object
- `kernel vaults items events <vault-id-or-name> <key>` - List an item's immutable audit events, oldest first
- `--after <event-id>` - Return only events after this event ID
- `--wait <seconds>` - Long-poll for new events for up to this many seconds (max 60). Together with `--after`, this follows an item's progress.
- `--output json`, `-o json` - Output raw JSON array
- `kernel vaults items delete <vault-id-or-name> <key>` - Delete an item; its secret value is invalidated
- `-y, --yes` - Skip confirmation prompt

### Projects

- `kernel projects list` - List projects (up to 100 by default)
Expand Down Expand Up @@ -618,6 +684,7 @@ Managed auth connections (`kernel auth connections`). The commands below are new
- `kernel auth connections submit <id>` - New flags:
- `--field-value <id=value>` - Canonical field-id=value pair from the connection's `fields` list (repeatable); preferred over the legacy `--field`
- `--choice-id <id>` - Canonical choice ID from the connection's `choices` list
- `--interaction-id <id>` - Canonical interaction the submitted values answer. Only valid with `--field-value` or `--choice-id`; omit it and the CLI reads the connection's current interaction ID for you. Pass it to pin the submission, so the API rejects it if the flow has already moved on.

`kernel auth connections get` and `follow` list those IDs alongside the metadata the API captured for them, so you can tell the options apart before submitting. Fields show their type, ref, and any hint (which names the masked destination a one-time code was sent to); choices show their type, semantic MFA method (`sms`, `totp`, `push`, …), and masked destination.

Expand Down
Loading
Loading