CLI reference
Two console scripts exist at the pinned revision. This reference enumerates
the command surface proven from the pinned source registrations — every
row below corresponds to a command registration in the cited modules.
Per-flag semantics live in each command's --help and in the synchronized
quickstarts; this page does not restate flags it cannot cite.
market — the buyer CLI
Ships in arkhai-core-buyer; domain plugins register their command groups
onto the core app at startup. market plugins lists installed domains, and
market --version prints the core version plus one line per installed
domain with its contract version. Core source:
core_buyer/cli.py.
Core
| Command | Purpose |
|---|---|
market --version | Print core and installed-domain versions (local). |
market --help | List registered command groups (local). |
market plugins | List installed buyer market domains. |
market listing list · show | Generic Registry browsing (raw JSON, --filter name=value passthrough) when no installed domain claims listing. |
VM compute plugin (arkhai-vms-buyer)
Registered in domains/vms/buyer/cli.py:
| Command | Purpose |
|---|---|
market listing list · show | Browse marketplace listings. |
market config path · show · get · set · init-user | Inspect or edit buyer.toml. |
market logs runs · show · tail | Inspect past buy/negotiate run logs (JSONL). |
market buy | Discover, negotiate, escrow, settle, and poll to a ready VM; --from <run_id> resumes. |
market negotiate | Run the negotiation stage against a listing. |
market settle | Escrow-create, settle, and poll for an already-agreed run (--from). |
market service | Service-stage operations for a deal. |
market escrow create · reclaim · show | Buyer-side escrow lifecycle. |
market chain check | Sanity-check chain config (eth_getCode against configured addresses). |
market network join · get-peers | Join an operator's ZeroTier overlay and list peers. |
API-credits plugin
Registered in
domains/apicredits/buyer/cli.py
under one credits group:
| Command | Purpose |
|---|---|
market credits listing list · show | Browse API-credit listings. |
market credits buy | Buy prepaid credits; settlement output includes the issued bearer secret. |
market credits negotiate | Negotiation stage for an API-credit listing. |
market credits settle | Settlement stage for an agreed API-credit run. |
The Inference API credits
cookbook shows a complete market credits buy invocation with its flags.
market-storefront — the seller admin CLI
Ships with the VM storefront; runs inside (or against) the storefront deployment. Source: market_storefront/cli.py.
| Command | Purpose |
|---|---|
market-storefront serve | Run the storefront server. |
market-storefront publish --inventory <csv> | Post listings from the agent database to configured Registries. |
market-storefront portfolio import-csv | Import local resource portfolio data. |
market-storefront config path · show · get · set · init-user | Inspect or edit the storefront configuration. |
market-storefront logs … | Inspect storefront stage events from the local SQLite log. |
market-storefront escrow claim · refund | Seller-side escrow lifecycle. |
market-storefront network … | Join an operator's ZeroTier overlay and list peers. |
Boundaries
- This page proves command existence and purpose from source registrations at the pin; it does not claim flag-level stability across revisions.
- Both CLIs act only under the invoking participant's authority and configuration — there is no shared or hosted execution surface.
market config showandmarket-storefront config showserialize the full loaded configuration and can expose wallet private keys or Registry tokens. Do not paste, share, or attach their output. Preferconfig get <key>for one deliberately selected non-secret value.