Skip to main content

CLI commands

Every command accepts the global flags (--config, --data-dir, --verbose) and --help. Run antseed <command> --help for the full flag list of any command. Most commands that print data accept --json.

You normally configure a node once (antseed seller setup, antseed config …) and then start it with antseed buyer start, antseed gateway start or antseed seller start without repeating flags. Secrets such as upstream API keys stay in environment variables; everything else lives in ~/.antseed/config.json.

Buyer​

Run the local buyer proxy (port 8377) that pays sellers. Guides: Local buyer API, Buyer configuration.

CommandPurposeKey flags
antseed buyer startStart the buyer proxy and connect to sellersSee buyer start flags
antseed buyer statusShow connection status and balance--json
antseed buyer connection getShow the running buyer's session peer pin
antseed buyer connection setPin every request on the running buyer to one seller--peer <peerId>
antseed buyer connection clearClear the session peer pin
antseed buyer identity create <name>Create an extra buyer identity with its own wallet--key-from env:<VAR> or --key-from file:<path>
antseed buyer identity listList buyer identities--balances, --json
antseed buyer identity protect [name]Encrypt stored wallet keys with ANTSEED_PASSPHRASE (at least 12 characters)--all
antseed buyer identity unprotect [name]Store encrypted wallet keys as plaintext again--all, --yes
antseed buyer identity remove <name>Stop using an identity; its key is archived, not deleted
antseed buyer activityTokens, spending history, savings, active channels and claimable ANTS--days 7|30|90, --json
antseed buyer meteringChannel and usage stats, after checking active channels on-chain--peer <peerId>, --json

A running buyer can pay as any identity; select one per request with the x-antseed-buyer-identity header.

Gateway​

Serve the buyer API to many users with API keys, spend limits, routing policies and the Gateway Console (API on port 8379, console at /console). Guides: Gateway, API keys, Budgets, Routing, Sign-in, Activity, Migrate to a server, Wallet keys, Management API.

Run and sign in​

CommandPurposeKey flags
antseed gateway startRun the gateway and its console locally; also starts a buyer--port (8379), --host (127.0.0.1), --public-url <url>, --no-buyer, --buyer-port, --no-console, --x402-facilitator <url|cdp|payai>, --topup-min-usd (2), --topup-max-usd (500)
antseed gateway service installRun gateway start as a background service that starts at login and restarts if it exits: a launchd agent on macOS, a systemd user service on Linux; no root. Run it again to update the service--port (8379), --wait <seconds> (120; 0 to not wait)
antseed gateway service statusWhether the service is installed, running and answering; exits 1 when it isn't answering--port (8379)
antseed gateway service uninstallStop the service and remove it; keys, wallets and settings stay
antseed gateway console-linkPrint the one-time owner setup link, or the console URL once it has an owner--recover, --member <id|email>, --public-url, --port
antseed gateway peersSellers the running buyer knows, with trust, TEE, prices and this gateway's 24 h stats--model <id>, --tee
antseed gateway settings showShow buyer and observability settings--reveal
antseed gateway settings set-buyerChange buyer settings (price caps, allow/block lists, verifiers, RPC, timeouts)--max-input-price, --max-output-price, --min-trust, --allow-peer, --block-peer, --auto-sweep on|off, --rpc-url
antseed gateway settings set-observabilityChange OTLP export, content logging and log retention--otlp-endpoint, --otlp-header name=value, --log-content on|off, --retention-days

API keys​

CommandPurposeKey flags
antseed gateway key createCreate an API key; the secret is shown once--label, --workspace, --owner <member>, --identity <name>, --new-identity [name], --daily-limit, --weekly-limit, --monthly-limit, --total-limit, --expires-in-days, --allow-topup
antseed gateway key listList keys with spend and limits--all, --workspace, --member
antseed gateway key show <id>Show a key's usage, both limit layers and policies
antseed gateway key limits <id>Change a key's admin-layer spend caps (none removes one)--daily-limit, --weekly-limit, --monthly-limit, --total-limit
antseed gateway key update <id>Change label, admin and owner limits, expiry, owner or top-ups--owner-daily-limit, --owner-weekly-limit, --owner-monthly-limit, --owner-total-limit, --owner <member|none>, --expires-in-days, --no-expiry, --topup on|off
antseed gateway key topup <id> on|offAllow or stop x402 top-ups of the key's wallet
antseed gateway key rotate <id>Issue a new secret; the old one stops working
antseed gateway key revoke <id>Revoke a key immediately
antseed gateway key usage <ids...>Requests, spend and savings summed over keys, revoked ones included--json
antseed gateway key policy show <id>Show both policy layers and the effective policy--preset <slug>
antseed gateway key policy set <id>Set a key's routing policy--layer admin|owner, policy flags
antseed gateway key policy clear <id>Remove a key's policy at one layer--layer admin|owner

Members and management tokens​

CommandPurposeKey flags
antseed gateway member invitePrint a single-use invite link--label, --email, --role member|admin|owner, --workspace <id|name[:admin]>, --expires-in-hours (72)
antseed gateway member invitesList open invites
antseed gateway member cancel-invite <inviteId>Cancel an open invite
antseed gateway member listList console members
antseed gateway member show <member>Show role, workspaces, limits, key quota, policy and sign-in methods
antseed gateway member update <member>Change name, email, org role, spend caps across their keys, key quota--role, --max-keys, --daily-limit, --monthly-limit, --total-limit
antseed gateway member policy show|set|clear <member>A member's routing policy, applied to every key they ownpolicy flags
antseed gateway member disable <member>End their sessions and revoke the keys they own
antseed gateway member enable <member>Re-enable a member (revoked keys stay revoked)
antseed gateway member credentials list <member>List a member's sign-in methods
antseed gateway member credentials remove <member> <credentialId>Remove a sign-in method and end their sessions--allow-last
antseed gateway admin-token createCreate a management token for /console/api--label, --scope read|admin, --expires-in-days (90, max 365), --no-expiry
antseed gateway admin-token listList active management tokens
antseed gateway admin-token revoke <id>Revoke a management token

Workspaces​

CommandPurposeKey flags
antseed gateway workspace listList workspaces with wallets, members, keys and budgets
antseed gateway workspace createCreate a workspace with a new wallet, or an existing identity--name, --identity, --daily-limit, --weekly-limit, --monthly-limit, --total-limit
antseed gateway workspace show <workspace>Show wallet, budgets, spend, policies and members
antseed gateway workspace update <workspace>Rename a workspace or change its budgets--name, --daily-limit, --monthly-limit, --total-limit
antseed gateway workspace delete <workspace>Delete a workspace with no active keys or funds
antseed gateway workspace policy show|set|clear <workspace>Workspace routing policies--layer workspace|org, policy flags
antseed gateway workspace member list <workspace>List a workspace's members and roles
antseed gateway workspace member add <workspace> <member>Add a member--role admin|member
antseed gateway workspace member role <workspace> <member> <role>Change a member's workspace role
antseed gateway workspace member remove <workspace> <member>Remove a member; their keys in it are revoked
antseed gateway workspace operator show <workspace>Show the workspace wallet's authorized wallet, read from the chain
antseed gateway workspace operator authorize <workspace> [address]Sign the authorization for an authorized wallet, or open the wallet page--browser, --no-open, --yes
antseed gateway workspace operator transfer <workspace> [address]Hand the authorized-wallet role on (the workspace wallet pays gas)--clear, --yes

Routing, peer lists and presets​

CommandPurposeKey flags
antseed gateway routing showShow the gateway default policy, or the effective policy for a key, workspace, member or preset--key, --workspace, --member, --preset
antseed gateway routing setSet the gateway default policy every key inheritspolicy flags
antseed gateway routing clearRemove the gateway default policy
antseed gateway routing previewRank the sellers a request would route to, with exclusion reasons--model <peerId@model>, --key, --workspace, --member, --preset, --all
antseed gateway peer-list listList named seller lists
antseed gateway peer-list show <list>Show a list's sellers
antseed gateway peer-list createCreate a seller list--name, --description, --peer <peerId>
antseed gateway peer-list update <list>Rename, describe or replace a list's sellers--name, --description, --peers
antseed gateway peer-list add|remove <list> <peerIds...>Add or remove sellers--confirm-empty
antseed gateway peer-list delete <list>Delete a list--confirm-empty
antseed gateway preset listList presets--workspace
antseed gateway preset show <preset>Show a preset--workspace <id|name|org>
antseed gateway preset createCreate a preset, called as model @preset/<slug>--slug, --name, --model, --workspace, --system-prompt, --system-prompt-file, --param key=value, --params-file, policy flags
antseed gateway preset update <preset>Change a preset--in-workspace, --slug, --name, --model, --clear-policy, policy flags
antseed gateway preset delete <preset>Delete a preset--workspace <id|name|org>

Routing policy flags​

key policy set, member policy set, workspace policy set, routing set and preset create|update share these flags:

FlagEffect
--file <path>Read the policy as JSON; other flags override its fields
--mergeStart from the current policy instead of replacing it
--allow-peer <peerId>, --block-peer <peerId>Allow only, or never route to, a seller (repeatable)
--allow-list <list>, --block-list <list>Allow only, or block, the sellers in a peer list (repeatable)
--allow-model <model>Allow only these models (repeatable)
--min-trust <score>, --min-reputation <score>Minimum seller trust score or reputation, 0–100
--max-input-price, --max-output-price, --max-cached-input-pricePrice caps in USD per million tokens. Without --max-cached-input-price, the input cap also caps cached input
--require-tee, --require-verifiedOnly sellers advertising TEE attestation, or whose responses pass a verifier
--prefer-freeRank free sellers first
--sort balanced|price|latency|trustHow eligible sellers are ranked
--confirm-empty, --accept-narrowedSave even if no seller could serve, or if levels above allow less

Usage, logs and moving a gateway​

CommandPurposeKey flags
antseed gateway usageSpend, requests and tokens over a period (default: last 30 days)--workspace, --key, --member, --model, --from, --to, --group-by day|model|key|member|peer|workspace|user
antseed gateway logs [list]Recent requests, newest first--status, --search, --limit (50, max 200), --before, --follow, --interval (2000 ms)
antseed gateway logs show <tag>One request in full, with bodies when content logging is on
antseed gateway auditAudit log of console and CLI changes--action <verb>, --actor <id>, --limit (100, max 500)
antseed gateway exportExport the request log as CSV (never bodies)--output <file>, same filters as logs
antseed gateway export --out <file>Write the whole gateway to a password-encrypted bundle--password-file, --force
antseed gateway import <bundle>Restore a bundle into this machine's data dir (gateway and buyer stopped)--password-file, --public-url, --port, --force

Tunnel​

Publish the gateway (API and, by default, the console) through a public HTTPS tunnel endpoint. Guide: Public tunnels.

CommandPurposeKey flags
antseed tunnel startExpose the local gateway through an authenticated HTTPS tunnel--provider cloudflare|ngrok, --gateway-port (8379), --buyer-port (8377), --no-buyer, --no-console
antseed tunnel statusShow tunnel status--json
antseed tunnel stopStop the tunnel

Chat​

Chat with an agent through a gateway from the terminal. Web search, web pages and scratch files run on the gateway, which keeps the history. Guide: Console chat.

CommandPurposeKey flags
antseed chatStart a terminal chat through a gateway--gateway <url>, --key <apiKey>, --workspace, --model <id>, --peer <peerId|any>, --resume <threadId>, --history

Apps and tool wrappers​

Point local AI tools at the buyer proxy. Guides: Desktop app, Local buyer API.

CommandPurposeKey flags
antseed apps statusList supported apps: installed, connected, config path--json
antseed apps connect <app>Point an app's config at the buyer proxy (backs up the original)--port <buyerPort>
antseed apps disconnect <app>Remove only what Antseed added to an app's config
antseed claude [args...]Run Claude Code through the buyer proxy--model <service-id>, --antseed-base-url <url>
antseed codex [args...]Run Codex through the buyer proxy--model <service-id>, --antseed-base-url <url>
antseed opencode [args...]Run OpenCode through the buyer proxy--model <service-id>, --antseed-base-url <url>
antseed system-proxy install-caGenerate and trust the local CA certificate
antseed system-proxy ca-trust-stateReport whether the OS trusts the local CA (JSON)
antseed system-proxy startStart the local System Proxy--peer <peerId>, --default-model, --served-model, --port (8378), --buyer-port (8377), --profile, --system-proxy
antseed system-proxy stopStop the System Proxy
antseed system-proxy statusShow System Proxy status

The wrappers forward unknown flags to the tool. --model falls back to ANTSEED_MODEL.

Seller​

Offer AI services on the network. Guides: Become a provider, Provider configuration, Monitoring.

CommandPurposeKey flags
antseed seller setupInteractive setup: configure a provider and add services, with input, output and cached-input prices (cached at most input)
antseed seller startStart providing services--provider <names>, --input-usd-per-million, --output-usd-per-million, --reserve, --dht-port (6881), --signaling-port (6882), --min-settle-delta <usdc>, --base-rpc-url, --verifiers <ids>, --no-dashboard, --dashboard-port (3120), --skip-prereq-check
antseed seller statusShow node status and readiness--json
antseed seller registerRegister your peer identity on-chain (ERC-8004)--agent-id <id>, --metadata <uri>
antseed seller doctorDiagnose the announced seller endpoint--timeout-ms (3000), --json
antseed seller forwardPublic entry point for a seller without a reachable IP (e.g. a TEE seller on Phala Cloud): carries buyers' TCP over TLS to its gateway and announces it on the DHT--to <host[:port]>, --peer <peerId>, --port (6882), --dht-port (6881), --max-connections (4096); closes a connection idle for 2 minutes
antseed seller dashboardOpen the local seller dashboard: the running seller's, or one served by this command--port (3120), --host (127.0.0.1), --no-open
antseed seller eventsRecent seller events: starts and stops, models failing or recovered, gas, alerts--limit (25), --json
antseed seller usageRequests, tokens and revenue per UTC day--days (14, up to 30), --json
antseed seller logsServed requests, newest first, or everything kept about one request--limit (50), --cursor, --model, --buyer, --since <30m|6h|2d|date>, --errors, --id <id>, --json
antseed seller marketYour prices against other sellers of the same models--model <id>, --refresh, --json
antseed seller reputationTrust score, its parts, and on-chain standing--refresh, --json
antseed seller promotePromotion info and a shareable seller card--card <file> (SVG), --json
antseed seller verifyDomain and GitHub identity claims--add-domain, --add-github <user[/repo]>, --remove <claim>, --check, --json
antseed seller settingsShow the seller's settings--json
antseed seller settings setChange settings (validated; written to config.json, or saved over it in the data dir when it is read-only)--display-name, --max-buyers, --health <on|off>, --health-interval, --health-failures, --gas <on|off>, --gas-min <eth>, --free-per-address, --free-per-ip, --free-window-hours, --free-stakers-only, --free-stake-tiers, --model-free-tier, --countries, --price <[provider/]model=in/out[/cached]>, --unit-price <[provider/]model[match]=usd>, --model-off, --model-on, --json
antseed seller settings add-model <[provider/]model>Add a model billed by tokens under a configured provider--input, --output, --cached, --upstream, --categories, --json
antseed seller settings remove-model <[provider/]model>Remove a model from the config (use set --model-off to keep its settings)--json
antseed seller settings resetRemove the settings saved over a read-only config.json; it applies alone from the next restart--json
antseed seller alertsWhere alerts go and their last delivery--json
antseed seller alerts setConfigure Telegram and webhook alerts (secrets from stdin only)--telegram-token-stdin, --telegram-chat <id>, --clear-telegram-token, --webhook-url-stdin, --clear-webhook, --idle <minutes|off>, --cooldown, --low-balance <usd|off|default>, --min-severity, --json
antseed seller alerts testSend a test alert--channel <telegram|webhook>, --json
antseed seller alerts find-chatFind the Telegram chat id after messaging your bot--token-stdin, --json
antseed profile showShow your peer profile
antseed profile setCreate or update your peer profile--name, --description, --tags, --capabilities, --region, --languages, --website

Payments and channels​

Fund the buyer and manage payment channels. Guides: Gateway funding, Seller payouts, Payments protocol.

CommandPurposeKey flags
antseed buyer depositShow your USDC funding address and QR code; incoming funds are deposited automatically (gasless)--amount <usdc>, --no-watch
antseed buyer deposit --onchain <usdc>Legacy: deposit directly from the buyer wallet (needs ETH for gas)
antseed buyer sweepSweep wallet USDC into your deposits balance via relayers (fixed USDC fee)--amount <usdc>, --timeout (120 s)
antseed buyer balanceShow your deposits balance--json
antseed buyer withdraw <amount>Withdraw USDC from the deposits contract
antseed buyer set-authorized-walletAuthorize an external wallet in the browser, or the buyer wallet itself--self, --no-open, --identity <name>
antseed buyer free-tier add <code>Add a free-tier code a staker created for this buyer in the ANTS dashboard--identity <name>
antseed buyer free-tier shareSign in the browser to share a wallet's ANTS stake with this buyer for staked free tiers--no-open, --identity <name>
antseed buyer free-tier listList the stakers sharing with this buyer and the stake each seller pool counts, with when it runs down--identity <name>, --no-stake
antseed buyer free-tier remove <staker>Stop sending a staker's delegation--identity <name>
antseed buyer channels [list]List payment channels from the local store, after checking active ones on-chain--status active|settled|timeout|ghost, --limit (20)
antseed buyer channels close <channelId>Ask the seller to close a channel now--no-auth
antseed buyer channels request-close <channelId>Start a timeout close so reserved funds can be withdrawn after the grace period
antseed buyer channels withdraw <channelId>Release reserved funds after the grace period
antseed paymentsPrint the commands that replaced the retired payments portal

Staking and ANTS​

Stake ANTS and claim rewards. Guides: Staking, Recognized usage, Legacy emissions.

CommandPurposeKey flags
antseed antsOpen the local ANTS staking dashboard--port (3119), --no-open, --address <address>
antseed ants statusProtocol phase, epoch, balances, stake and claimable rewards
antseed ants positionsList your lANTS staking positions
antseed ants stake <amount>Stake ANTS into a seller agent pool--agent <agentId>, --epochs <n> (1 epoch = 1 week)
antseed ants move <ids...>Move positions to another pool--to <agentId>
antseed ants split <id> <amount>Split ANTS out of a position
antseed ants merge <ids...>Merge positions with the same pool and lock end
antseed ants extend <id>Extend a lock--epochs <n>
antseed ants max-lock <id>Enable max lock on a position--off
antseed ants withdraw <ids...>Withdraw positions (early exits burn part of the principal)--preview, --accept-slashing, --yes
antseed ants rewardsView rewards (staker, seller usage, buyer usage, legacy, locked)
antseed ants rewards claimClaim rewards into the wallet--staker, --seller, --buyer, --legacy, --locked, --recipient <address>
antseed ants rewards restake [ids...]Restake staker rewards into a new locked position--epochs <n>
antseed ants rewards compoundRestake every restakable reward--epochs <n>, --to <agentId>
antseed ants rewards stake-usageClaim usage rewards straight into a locked position--side seller|buyer, --epochs <n>, --agent <agentId>
antseed ants poolsCompare seller pools
antseed ants pool <agentId>Show one seller pool
antseed ants usageYour usage points per epoch and network totals--epochs (8)
antseed ants emissionsEmission schedule, gate buckets and reward shares
antseed ants addressesContract addresses in use
antseed ants sellerSeller staking state: identity binding, eligibility, starter grant
antseed ants seller registerBind your agent ID in the seller registry (same as antseed seller register)--agent-id <id>
antseed ants verify [seller]Wash-trading verification status
antseed ants verify submit <artifact>Stage, authenticate and finalize a seller proof (resumable)--yes
antseed ants verify proof <proofId>Show a proof's progress
antseed seller stake <amount>Stake ANTS into your own seller pool--epochs <n> (required)
antseed seller pool positionsList your seller-pool positions
antseed seller pool withdraw <ids...>Withdraw seller-pool positions--accept-slashing, --yes
antseed seller rewardsView all seller ANTS rewards
antseed seller rewards claimClaim all pending seller ANTS rewards
antseed buyer emissions infoCurrent epoch and pending buyer emissions--legacy-only, --new-only
antseed buyer emissions claimClaim pending buyer ANTS emissions--legacy-only, --new-only

Legacy​

These commands apply only to the pre-upgrade USDC staking. See Legacy emissions.

CommandPurposeKey flags
antseed seller legacy stake <amount>Legacy: stake USDC (10 = 10 USDC)--agent-id <id>
antseed seller legacy unstakeLegacy: withdraw USDC stake (subject to slash conditions)
antseed seller legacy claim-starterClaim the legacy-seller starter ANTS position
antseed ants seller claim-starterSame as antseed seller legacy claim-starter

Network​

Browse sellers and run network infrastructure. Guides: Routing and catalog, Discovery.

CommandPurposeKey flags
antseed network browseBrowse peers: prices, services and on-chain settlements--service <name>, --tag <tags>, --services, --sort score|volume|sessions|price|recent, --top (20), --json
antseed network peer <peerId>Full details for one peer--tag <tags>, --json
antseed peer <peerId>Not implemented yet: prints the ID and a notice, without looking the peer up. Use antseed network peer <peerId>
antseed network bootstrapRun a dedicated DHT bootstrap node (no provider, no payments)--port (6881), --bootstrap <host:port,...>

Verifier​

Run KBF audits of sellers' model claims (one of the first of many verification methods), submit results on-chain and claim auditor rewards. Guides: Become a verifier, How audits run.

CommandPurposeKey flags
antseed verifier modelsList the built-in audited models and where each takes its genuine answers from--json
antseed verifier run [model]Audit the sellers your buyer has discovered, for the models assigned to your auditor this epoch (or one <model>)--all, --auditor <address>, --peer <peerId>, --no-enroll, --max-enrollment-requests <n>, --resume-run <runId>, --ignore-pre-run-checks, --fresh, --max-rounds <n>, --no-confirm, --skip-version-check
antseed verifier watchKeep auditing: every interval, run your assigned models and the confirmations you're responsible for, then submit (with --no-submit, only audit: nothing is signed or submitted)--interval <minutes>, --once, --no-submit, --auditor <address>, --keystore <path>, --rpc-url <url>, --no-publish-ipfs, --skip-version-check, and run's --max-rounds <n>, --max-enrollment-requests <n>, --no-enroll, --ignore-pre-run-checks, --no-confirm
antseed verifier assignmentShow which models each approved auditor audits; every model is audited every epoch, split round robin--epoch <n>, --epochs <count>, --json
antseed verifier statusProgress of the latest run--json
antseed verifier logsList this auditor's automatic daily logs (kept 14 days), or pack them, with secrets removed, into one .log.gz file to share--bundle, --days <n> (7, newest daily logs to bundle), --out <path>
antseed verifier overviewWrite the seller × model overview page of an epoch from all its runs, with the reason for every inconclusive or skipped result--epoch <n>, --run <ids...>
antseed verifier submitPublish evidence and submit one audit per model for the whole current epoch (approved auditors); only results not already on-chain are sent, and a model with nothing new is skipped--run-id <id> (one run only), --dry-run, --no-publish-ipfs, --publish-only, --auditor <address>, --keystore <path>, --yes, --rpc-url, --skip-version-check
antseed verifier rewardsCredits and pending ANTS per epoch; claim finished epochs--epochs <list>, --claim, --yes, --auditor <address>, --rpc-url
antseed verifier check <model>Re-run the latest published audit against any endpoint. Exit code 0 SAME, 2 DIFF, 3 UNDETERMINED--base-url <url>, --target-model <id>, --protocol openai|anthropic, --api-key-env (VERIFY_API_KEY), --audit <ipfs://cid>, --ipfs-gateway, --out <file>, --json

Config​

Read and change ~/.antseed/config.json. Guides: Buyer configuration, Provider configuration.

CommandPurposeKey flags
antseed config initCreate a config file with defaults
antseed config showShow the configuration (credentials redacted)
antseed config set <key> <value>Set a value at an existing key path, for example seller.reserveFloor 20. Unknown keys are rejected; see Seller configuration
antseed config buyer showShow buyer configuration
antseed config buyer set <key> <value>Set a buyer value, for example maxPricing.defaults.inputUsdPerMillion 25
antseed config seller showShow seller configuration
antseed config seller set <key> <value>Set a seller value
antseed config seller add-provider <name>Add a provider (installs its plugin)--plugin <name>, --base-url, --input, --output, --cached
antseed config seller remove-provider <name>Remove a provider
antseed config seller add-service <provider> <serviceId>Add a service under a provider--upstream, --venice-edit-model <model> (Venice only: the native edit model that serves /v1/images/edits for this image service; see Venice image edits), --input, --output, --cached, --categories, --capabilities <json>, --unit-billing-models <json>, --base-url
antseed config seller remove-service <provider> <serviceId>Remove a service

Other​

CommandPurposeKey flags
antseed metrics serveServe Prometheus metrics (guide)--role buyer|seller|both|auto, --host (127.0.0.1), --port (9108), --path (/metrics), --instance, --include-chain
antseed agent dev <agentDir>Test an ant agent locally in an interactive chat--endpoint <url>, --api-key, --model
antseed updateInstall the latest CLI the way this copy was installed (details)--check (only report), --json
antseed help [command]Show help for a command

Updating​

antseed update asks the npm registry for the latest @antseed/cli and runs the matching command for how the CLI was installed: npm install -g, pnpm add -g, yarn global add, bun add -g or volta install. A global npm install in a root-owned prefix, Nix, npx, a project dependency or a source checkout only prints the command to run. On a server set up by the gateway installer it hands the install to the root update service, which also restarts the buyer and gateway. Restart any running buyer, seller or gateway you started yourself to use the new version.

Nothing updates by itself. Interactive commands print a one-line notice on stderr when a newer version is out. The registry is asked at most every 30 minutes, in the background, so the notice appears from the next run. It stays quiet with --json, when stderr is not a terminal, and in CI.

A running antseed seller start or antseed buyer start asks the registry every 30 minutes and logs one line the first time it sees each newer version, also when it runs as a service:

Text
Antseed 0.1.195 is available (this seller runs 0.1.193). Run antseed update, then restart the seller.

A gateway does the same and also shows it in its console (see Upgrade). Set NO_UPDATE_NOTIFIER or ANTSEED_NO_UPDATE_CHECK to turn all of these off. ANTSEED_NPM_REGISTRY (or npm's npm_config_registry) points the check at a mirror.