CLI command reference

Mechanical interfaces below come from the same Clap definitions as pond. Defaults shown are parser defaults, not every operational fallback. Parent commands group their documented subcommands. Global options are listed separately.

Choosing an operation

CommandsMode, side effects, and verified entry points
initCreates a new pond identity at --pond / POND; required immutable birthplace. Synthetic example.
list, describe, catPond or explicit host input. Listing enumerates; describe inspects schema; cat reads bytes or SQL results. A dynamic read can initialize/query caches or contact its declared source. CSV.
mkdir, copy, mknod, applyPond mutations. Copy can import host input; mknod installs a factory/config, not collected measurements. Apply is declarative create/update. Existing destinations/configs need the command's explicit semantics, not an assumed overwrite.
list-factoriesLists linked capabilities without a pond. Registration is not proof of host support or service readiness.
runExecutes a registered factory against the selected context. Host sitegen is supported; writable collectors/exec require a pond. Arguments after -- belong to the factory, whose own help/contract defines them.
exportWrites host Parquet from queryable input; not a whole-pond backup. Export semantics.
show, log, status, limitsPond/operator inspection. Log lifecycle data can differ from replicated logical data. Limits reports bounded limiter state, not a rescan of usage history.
backup, pushConfigure/advance whole-pond push destinations; may contact services and upload immutable data/publication records. Recovery package.
remote, pullConfigure/refresh pull mirrors or foreign imports. Removing an attachment is not deleting remote storage. --purge additionally removes a local import mount. Rebuild-graft requires a named remote.
restoreRequires an absent local target and adopts the backup's identity; then tracks it by pull. Not cross-pond import.
verify, fsck, tlogRemote checksum/tip verification, local integrity, and transparency-log inspection/verification are distinct checks. --exact requires tip equality.
recover, rebuild-controlRepair interrupted transaction metadata or reconstruct control state. Preserve evidence and assess status before mutation; not substitutes for independent backups.
maintainLocal checkpoint/vacuum and explicitly selected compaction/pruning/pack operations. Start with applicable dry-run inspection. Retention-only pruning can destroy recoverable history.
capsulePublish recipes/snapshots or inspect/verify/import downloaded recovery data. Import uses a fresh identity and resumable staging; activation is a separate safety preflight.
freezePersistently freeze data writes, inspect the protected tip, or explicitly re-enable writes. Does not stop external source changes.
configShow/set pond configuration, not arbitrary factory YAML fields. Changing operational settings can affect future transactions.
emergency erase-bucketDestructive external-storage deletion requiring explicit dangerous confirmation. Never part of quickstart, recovery, or routine validation.

Use the operations guide for ordering, recovery boundaries, capsule activation, and maintenance risks. Service-dependent commands are not reported as offline-tested just because their parser is compiled. Test 214 covers file-backed backup/restore/pull and subsequent updates; tests 057/100 cover the small query/install workflows.

apply

pond apply

Apply configuration files (idempotent create-or-update) Each file contains a prelude (kind, path, version) separated from the config body by '---'. Creates new nodes or updates changed ones.

Argument / optionAccepted valuesRequiredDefaultDescription
-f1.. value(s)yesnot specifiedConfiguration files to apply
-h, --helpflag (no value)nonot specifiedPrint help (see a summary with '-h')

Global options are documented in Global options.

backup

pond backup

Manage backup attachments (push-side of remote split, D5.7b)

Argument / optionAccepted valuesRequiredDefaultDescription
-h, --helpflag (no value)nonot specifiedPrint help

Global options are documented in Global options.

backup add

pond backup add

Attach a backup remote (push-only by default; --bidirectional makes it push+pull). Backups always mirror the entire pond

Argument / optionAccepted valuesRequiredDefaultDescription
--access-key-id, --access-key1 value(s)nonot specifiedS3 access key id
--allow-httpflag (no value)nofalseAllow plain HTTP (required for local MinIO)
--bidirectionalflag (no value)nofalseAlso pull from this remote (push + pull, i.e. mode=both)
--endpoint1 value(s)nonot specifiedCustom S3 endpoint (e.g., for MinIO or R2)
-h, --helpflag (no value)nonot specifiedPrint help
NAME1 value(s)yesnot specifiedLogical name for the backup (e.g., "origin", "backup-s3")
--overwriteflag (no value)nofalseReplace an existing attachment of the same name
--region1 value(s)nonot specifiedAWS region (S3 only)
--secret-access-key, --secret-key1 value(s)nonot specifiedS3 secret access key
URL1 value(s)yesnot specifiedRemote URL (file:///path or s3://bucket/prefix)

Global options are documented in Global options.

backup cleanup-uploads

pond backup cleanup-uploads

Delete abandoned immutable-payload upload staging objects

Argument / optionAccepted valuesRequiredDefaultDescription
-h, --helpflag (no value)nonot specifiedPrint help
NAME1 value(s)yesnot specifiedLogical name of the backup
--older-than-seconds1 value(s)no86400Delete staging objects at least this old

Global options are documented in Global options.

backup list

pond backup list

List backup-mode attachments only

Argument / optionAccepted valuesRequiredDefaultDescription
-h, --helpflag (no value)nonot specifiedPrint help

Global options are documented in Global options.

backup publish-consolidated

pond backup publish-consolidated

Publish verified local whole-range series packs to this backup. This is the only operation that installs remote consolidated-pack locators. It validates the backup's pond identity and exact current main publication, uploads immutable physical objects, then each pack, then its locator. It never runs as part of collection or ordinary push.

Argument / optionAccepted valuesRequiredDefaultDescription
-h, --helpflag (no value)nonot specifiedPrint help (see a summary with '-h')
NAME1 value(s)yesnot specifiedLogical name of a push/both backup

Global options are documented in Global options.

backup remove

pond backup remove

Remove a backup attachment (alias of pond remote remove for symmetry; same semantics: deletes config and clears watermarks). Backups have no mount_path, so --purge is a no-op for them but accepted for symmetry

Argument / optionAccepted valuesRequiredDefaultDescription
-h, --helpflag (no value)nonot specifiedPrint help
NAME1 value(s)yesnot specifiedLogical name of the backup to remove
--purgeflag (no value)nofalseAccepted for symmetry with pond remote remove --purge; has no effect on backups (no mount entry to purge)

Global options are documented in Global options.

capsule

pond capsule

Install recovery recipes or verify portable recovery capsules

Argument / optionAccepted valuesRequiredDefaultDescription
-h, --helpflag (no value)nonot specifiedPrint help

Global options are documented in Global options.

capsule activate

pond capsule activate

Safely enable post-commit dispatch on a completed capsule import. Reads and validates every restored /sys/remotes/* attachment and /system/run/* dynamic config without executing factories. Dispatch remains suppressed if any entry is invalid or unsafe.

Argument / optionAccepted valuesRequiredDefaultDescription
-h, --helpflag (no value)nonot specifiedPrint help (see a summary with '-h')

Global options are documented in Global options.

capsule import

pond capsule import

Import a pondcapsule.4 into a brand-new pond. The target must not already exist. A private sibling staging directory is created next to it, given a fresh pond identity, and populated in bounded, journaled transactions with post-commit factory execution and remote auto-push suppressed. Retrying the same command resumes the matching staging directory at an exact entry/leaf cursor. Only after the staged result is re-verified against the capsule's logical contract is it renamed atomically onto the target. On any failure the staging directory is left in place for inspection rather than silently removed. The promoted pond remains inert until pond capsule activate passes its safety preflight.

Argument / optionAccepted valuesRequiredDefaultDescription
--birthplace1 value(s)yesnot specifiedBirthplace of the freshly minted target pond identity (see pond init --birthplace)
-h, --helpflag (no value)nonot specifiedPrint help (see a summary with '-h')
PATH1 value(s)yesnot specifiedDirectory containing the downloaded recovery/ tree

Global options are documented in Global options.

capsule inspect

pond capsule inspect

Verify a downloaded pondcapsule.4 without opening a pond

Argument / optionAccepted valuesRequiredDefaultDescription
-h, --helpflag (no value)nonot specifiedPrint help
PATH1 value(s)yesnot specifiedDirectory containing the downloaded recovery/ tree

Global options are documented in Global options.

capsule publish

pond capsule publish

Build and publish the current portable pondcapsule.4 snapshot

Argument / optionAccepted valuesRequiredDefaultDescription
-h, --helpflag (no value)nonot specifiedPrint help
NAME1 value(s)yesnot specifiedLogical backup name

Global options are documented in Global options.

capsule recipe

pond capsule recipe

Publish or inspect a static native-format recovery recipe

Argument / optionAccepted valuesRequiredDefaultDescription
-h, --helpflag (no value)nonot specifiedPrint help

Global options are documented in Global options.

capsule recipe inspect

pond capsule recipe inspect

Verify the watertown.commit.v1 -> pondcapsule.4 recipe

Argument / optionAccepted valuesRequiredDefaultDescription
-h, --helpflag (no value)nonot specifiedPrint help
NAME1 value(s)yesnot specifiedRemote attachment name

Global options are documented in Global options.

capsule recipe publish

pond capsule recipe publish

Install the watertown.commit.v1 -> pondcapsule.4 recipe

Argument / optionAccepted valuesRequiredDefaultDescription
-h, --helpflag (no value)nonot specifiedPrint help
NAME1 value(s)yesnot specifiedBackup attachment name

Global options are documented in Global options.

capsule verify

pond capsule verify

Verify a pondcapsule.4 and all leaf identities

Argument / optionAccepted valuesRequiredDefaultDescription
-h, --helpflag (no value)nonot specifiedPrint help
PATH1 value(s)yesnot specifiedDirectory containing the downloaded recovery/ tree

Global options are documented in Global options.

cat

pond cat

Read a file from the pond

Argument / optionAccepted valuesRequiredDefaultDescription
--explainflag (no value)nofalseShow pattern resolution and schema without executing the query
--format1 value(s)noautoOutput format [default: auto] [possible values: auto, raw, table, csv] auto: table for queryable types, raw for non-queryable files
-h, --helpflag (no value)nonot specifiedPrint help
PATH1 value(s)yesnot specifiedFile path to read
--sql, --query1 value(s)nonot specifiedSQL query to execute on the file:series data
--time-end1 value(s)nonot specifiedTime range end (Unix timestamp in milliseconds, optional)
--time-start1 value(s)nonot specifiedTime range start (Unix timestamp in milliseconds, optional)

Global options are documented in Global options.

config

pond config

Show or set pond configuration

Argument / optionAccepted valuesRequiredDefaultDescription
-h, --helpflag (no value)nonot specifiedPrint help

Global options are documented in Global options.

config set

pond config set

Set a configuration value

Argument / optionAccepted valuesRequiredDefaultDescription
-h, --helpflag (no value)nonot specifiedPrint help
KEY1 value(s)yesnot specifiedConfiguration key
VALUE1 value(s)yesnot specifiedConfiguration value

Global options are documented in Global options.

copy

pond copy

Copy files into or out of the pond Copy IN (host -> pond): pond copy host:///file.csv /dest/path Entry type is encoded in the source URL: host:///file.csv -> raw data (default) host+table:///file.parquet -> queryable parquet table host+series:///file.parquet -> time-series parquet Copy OUT (pond -> host): pond copy '/pattern/**/*.series' host:///output/dir

Argument / optionAccepted valuesRequiredDefaultDescription
DEST1 value(s)yesnot specifiedDestination: pond path (copy IN) or host:///path (copy OUT)
-h, --helpflag (no value)nonot specifiedPrint help (see a summary with '-h')
SOURCES1.. value(s)yesnot specifiedSource paths: host URLs (copy IN) or pond paths/patterns (copy OUT)
--strip-prefix1 value(s)nonot specifiedStrip a leading path prefix from pond paths when copying OUT. e.g. --strip-prefix=/hydrovu copies /hydrovu/devices/123/foo.series to <dest>/devices/123/foo.series instead of <dest>/hydrovu/devices/123/foo.series

Global options are documented in Global options.

describe

pond describe

Describe file schemas and types

Argument / optionAccepted valuesRequiredDefaultDescription
-h, --helpflag (no value)nonot specifiedPrint help
PATTERN1 value(s)no*/Pattern to match (supports wildcards, defaults to "**/*")

Global options are documented in Global options.

emergency

pond emergency

Emergency operations (destructive, use with care)

Argument / optionAccepted valuesRequiredDefaultDescription
-h, --helpflag (no value)nonot specifiedPrint help

Global options are documented in Global options.

emergency erase-bucket

pond emergency erase-bucket

Erase all objects in an S3 bucket. Requires --dangerous flag

Argument / optionAccepted valuesRequiredDefaultDescription
--access-key1 value(s)yesnot specifiedS3 access key
--allow-httpflag (no value)nofalseAllow HTTP (non-TLS) connections
--dangerousflag (no value)nofalseRequired safety flag to confirm destructive operation
--endpoint1 value(s)yesnot specifiedS3 endpoint (e.g., "http://localhost:9000" for MinIO)
-h, --helpflag (no value)nonot specifiedPrint help
--region1 value(s)nous-east-1S3 region
--secret-key1 value(s)yesnot specifiedS3 secret key
URL1 value(s)yesnot specifiedS3 bucket URL (e.g., "s3://water-staging")

Global options are documented in Global options.

export

pond export

Export pond data to external Parquet files with time partitioning

Argument / optionAccepted valuesRequiredDefaultDescription
--dir1 value(s)yesnot specifiedOutput directory for exported files
--end-time1 value(s)nonot specifiedTime range end (human-readable, e.g., "2024-12-31 23:59:59", "2024-12-31T23:59:59Z")
-h, --helpflag (no value)nonot specifiedPrint help
-p, --pattern1 value(s)nonot specifiedFile patterns to export (e.g., "/sensors/*.series")
--rebuildflag (no value)nofalseDrop the temporal-reduce partial-aggregate cache before exporting, forcing a full recompute. A maintenance escape hatch: the cache is derived state, so discarding it can only cost time
--start-time1 value(s)nonot specifiedTime range start (human-readable, e.g., "2024-01-01 00:00:00", "2024-01-01T00:00:00Z")
--temporal1 value(s)noTemporal partitioning levels (comma-separated: year,month,day,hour,minute)

Global options are documented in Global options.

freeze

pond freeze

Manage the persistent pond-wide data-write freeze

Argument / optionAccepted valuesRequiredDefaultDescription
-h, --helpflag (no value)nonot specifiedPrint help

Global options are documented in Global options.

freeze disable

pond freeze disable

Re-enable data writes

Argument / optionAccepted valuesRequiredDefaultDescription
-h, --helpflag (no value)nonot specifiedPrint help

Global options are documented in Global options.

freeze enable

pond freeze enable

Reject future data writes; fails while another writer holds the pond

Argument / optionAccepted valuesRequiredDefaultDescription
-h, --helpflag (no value)nonot specifiedPrint help
--reason1 value(s)yesnot specifiedAuditable operator reason for freezing this pond

Global options are documented in Global options.

freeze status

pond freeze status

Report whether writes are frozen and show the protected content tip

Argument / optionAccepted valuesRequiredDefaultDescription
-h, --helpflag (no value)nonot specifiedPrint help

Global options are documented in Global options.

fsck

pond fsck

Filesystem-check: verify content checksums and Merkle trees, and print a single root checksum that exhaustively fingerprints every row in the pond (across all pond_ids). Two replicas are identical iff their root checksums match

Argument / optionAccepted valuesRequiredDefaultDescription
-h, --helpflag (no value)nonot specifiedPrint help
--quickflag (no value)nofalseSkip the content-rehash pass; compute only the structural root checksum (fast)
--verboseflag (no value)nofalsePrint a per-partition breakdown and content statistics in addition to the root checksum

Global options are documented in Global options.

init

pond init

Initialize a new pond

Argument / optionAccepted valuesRequiredDefaultDescription
--birthplace1 value(s)yesnot specifiedBirthplace of the pond: an immutable label for where this pond is created (for example a hostname, site, or deployment name). Recorded permanently in the pond's identity metadata
-h, --helpflag (no value)nonot specifiedPrint help

Global options are documented in Global options.

limits

pond limits

Show bounded per-limiter state without scanning usage history

Argument / optionAccepted valuesRequiredDefaultDescription
--formattable, json, jsonlnotableOutput format for operators or collectors
-h, --helpflag (no value)nonot specifiedPrint help

Global options are documented in Global options.

list

pond list

List files and directories (ls -l style)

Argument / optionAccepted valuesRequiredDefaultDescription
-a, --allflag (no value)nofalseShow all files including hidden ones
-h, --helpflag (no value)nonot specifiedPrint help
-l, --longflag (no value)nofalseShow full entry type names (e.g., table:series, table:dynamic)
PATTERN1 value(s)no*/Pattern to match (supports wildcards, defaults to "**/*")

Global options are documented in Global options.

list-factories

pond list-factories

List available dynamic node factories

Argument / optionAccepted valuesRequiredDefaultDescription
-h, --helpflag (no value)nonot specifiedPrint help

Global options are documented in Global options.

log

pond log

View transaction history and audit trail

Argument / optionAccepted valuesRequiredDefaultDescription
-h, --helpflag (no value)nonot specifiedPrint help
--incompleteflag (no value)nofalseShow incomplete operations (for recovery) Conflicts with: txn_seq.
--limit1 value(s)no10Number of recent transactions to show
--txn-seq1 value(s)nonot specifiedShow detailed lifecycle for a specific transaction sequence number Conflicts with: incomplete.

Global options are documented in Global options.

maintain

pond maintain

Run Delta Lake maintenance (checkpoint, vacuum, optional compaction)

Argument / optionAccepted valuesRequiredDefaultDescription
--allow-no-remoteflag (no value)nofalseWith --prune: permit pruning when no push-mode remote is attached (retention-only; pruned history is then unrecoverable)
--collapse-versions1 value(s)no0Repack native-v2 series whose live physical fanout exceeds this threshold into verified whole-range packs under local data/_packs. Pass 0 to disable (the default). This never rewrites or reclaims user logical-series rows; publish selected packs explicitly with pond backup publish-consolidated NAME
--compactflag (no value)nofalseAlso compact small parquet files into larger ones
--dry-runflag (no value)nofalseReport which local series packs would be rebuilt, without changing anything
-h, --helpflag (no value)nonot specifiedPrint help
--keep-txns1 value(s)no1000With --prune: number of most-recent transactions to always retain
--pruneflag (no value)nofalseAlso prune replicated control-table lifecycle history at or below a safe horizon, reclaimed by this same checkpoint + vacuum pass

Global options are documented in Global options.

mkdir

pond mkdir

Create a directory in the pond

Argument / optionAccepted valuesRequiredDefaultDescription
-h, --helpflag (no value)nonot specifiedPrint help
-p, --parentsflag (no value)nofalseCreate parent directories as needed (like mkdir -p)
PATH1 value(s)yesnot specifiedDirectory path to create

Global options are documented in Global options.

mknod

pond mknod

Create node (factory objects like CSV, SQL views, etc.)

Argument / optionAccepted valuesRequiredDefaultDescription
--config-path1 value(s)yesnot specifiedPath to configuration file for the factory
FACTORY_TYPE1 value(s)yesnot specifiedFactory type to create (use 'list-factories' to see all available types)
-h, --helpflag (no value)nonot specifiedPrint help
--overwriteflag (no value)nofalseOverwrite existing dynamic node with new configuration
PATH1 value(s)yesnot specifiedPath where the node will be created

Global options are documented in Global options.

pull

pond pull

Pull new bundles from one or more remotes (D4)

Argument / optionAccepted valuesRequiredDefaultDescription
-h, --helpflag (no value)nonot specifiedPrint help
NAME1 value(s)nonot specifiedRemote name. Omit to pull every remote in pull or both mode
--rebuild-graftflag (no value)nofalseAtomically replace this remote's graft partition, mount, and pin

Global options are documented in Global options.

push

pond push

Push pending local transactions to one or more remotes (D4)

Argument / optionAccepted valuesRequiredDefaultDescription
-h, --helpflag (no value)nonot specifiedPrint help
NAME1 value(s)nonot specifiedRemote name (from pond remote add). Omit to push every remote in push or both mode

Global options are documented in Global options.

rebuild-control

pond rebuild-control

Rebuild the control table from the data Delta table when the control table is lost or corrupt (D6). Recovers pond identity and the transaction-log skeleton; settings/watermarks must be re-established by re-attaching remotes

Argument / optionAccepted valuesRequiredDefaultDescription
--forceflag (no value)nofalseMove an existing control table aside (to control.bak.<ts>) and rebuild. Required when a control table already exists
-h, --helpflag (no value)nonot specifiedPrint help

Global options are documented in Global options.

recover

pond recover

Recover from crash by checking and restoring transaction metadata

Argument / optionAccepted valuesRequiredDefaultDescription
-h, --helpflag (no value)nonot specifiedPrint help

Global options are documented in Global options.

remote

pond remote

Manage remote attachments under /sys/remotes/ (D4)

Argument / optionAccepted valuesRequiredDefaultDescription
-h, --helpflag (no value)nonot specifiedPrint help

Global options are documented in Global options.

remote add

pond remote add

Attach a pull-mode remote and mount it at PATH. PATH = / is a mirror restart (foreign store_id must match this pond's pond_id). Non-root PATH is a cross-pond import (foreign store_id must differ).

Argument / optionAccepted valuesRequiredDefaultDescription
--access-key-id, --access-key1 value(s)nonot specifiedS3 access key id
--allow-httpflag (no value)nofalseAllow plain HTTP (required for local MinIO)
--endpoint1 value(s)nonot specifiedCustom S3 endpoint (e.g., for MinIO or R2)
-h, --helpflag (no value)nonot specifiedPrint help (see a summary with '-h')
NAME1 value(s)yesnot specifiedLogical name for the remote (e.g., "upstream")
--overwriteflag (no value)nofalseReplace an existing attachment of the same name
PATH1 value(s)yesnot specifiedIn-pond mount path. Use / for a mirror restart of this pond's own backup, or /imports/<name> for cross-pond import
--region1 value(s)nonot specifiedAWS region (S3 only)
--secret-access-key, --secret-key1 value(s)nonot specifiedS3 secret access key
URL1 value(s)yesnot specifiedRemote URL (file:///path or s3://bucket/prefix)

Global options are documented in Global options.

remote list

pond remote list

List all attached remotes (both pull and backup)

Argument / optionAccepted valuesRequiredDefaultDescription
-h, --helpflag (no value)nonot specifiedPrint help

Global options are documented in Global options.

remote remove

pond remote remove

Remove a remote attachment and clear its watermarks. By default this is a detach: the YAML config and watermark keys are removed but any cross-pond mount entry materialized at mount_path is kept (the imported data snapshot stays readable). Pass --purge to also remove the mount entry itself (the foreign data becomes inaccessible by path even if it remains in the Delta log).

Argument / optionAccepted valuesRequiredDefaultDescription
-h, --helpflag (no value)nonot specifiedPrint help (see a summary with '-h')
NAME1 value(s)yesnot specifiedLogical name of the remote to remove
--purgeflag (no value)nofalseAlso remove the mount entry at the remote's mount_path (cross-pond imports only). Without this flag the imported data remains visible via the existing mount path

Global options are documented in Global options.

restore

pond restore

Restore a whole pond from a backup published to a remote. Bootstraps a FRESH replica: discovers the source pond's id from the remote, stamps a local pond carrying that id, attaches the remote as a mirror at /, and pulls the full content graph. Refuses to run over an existing pond. Use pond pull <name> afterward to track the upstream.

Argument / optionAccepted valuesRequiredDefaultDescription
--access-key-id, --access-key1 value(s)nonot specifiedS3 access key id
--allow-httpflag (no value)nofalseAllow plain HTTP (required for local MinIO)
--endpoint1 value(s)nonot specifiedCustom S3 endpoint (e.g., for MinIO or R2)
-h, --helpflag (no value)nonot specifiedPrint help (see a summary with '-h')
NAME1 value(s)yesnot specifiedLogical name to attach the restored mirror under (e.g., "origin")
--overwriteflag (no value)nofalseReplace an existing attachment of the same name
--region1 value(s)nonot specifiedAWS region (S3 only)
--secret-access-key, --secret-key1 value(s)nonot specifiedS3 secret access key
URL1 value(s)yesnot specifiedRemote URL (file:///path or s3://bucket/prefix) of the backup

Global options are documented in Global options.

run

pond run

Execute a run configuration (e.g., hydrovu collector)

Argument / optionAccepted valuesRequiredDefaultDescription
ARGS0.. value(s)nonot specifiedAdditional arguments to pass to the factory (e.g., subcommands like 'replicate', 'list-bundles')
-h, --helpflag (no value)nonot specifiedPrint help
PATH1 value(s)yesnot specifiedPath to the configuration file to execute

Global options are documented in Global options.

show

pond show

Show pond contents

Argument / optionAccepted valuesRequiredDefaultDescription
-h, --helpflag (no value)nonot specifiedPrint help
-m, --mode1 value(s)nobriefDisplay mode: brief (summary stats), concise (1 line per tx), or detailed (full dump)

Global options are documented in Global options.

status

pond status

Show an operator-facing status aggregate: identity, local commit state, recovery health, and per-remote sync watermarks (D6)

Argument / optionAccepted valuesRequiredDefaultDescription
-h, --helpflag (no value)nonot specifiedPrint help

Global options are documented in Global options.

tlog

pond tlog

Inspect and verify the pond's transparency log (D5)

Argument / optionAccepted valuesRequiredDefaultDescription
-h, --helpflag (no value)nonot specifiedPrint help

Global options are documented in Global options.

tlog show

pond tlog show

Show the current checkpoint, checkpoint history, and tree size

Argument / optionAccepted valuesRequiredDefaultDescription
-h, --helpflag (no value)nonot specifiedPrint help

Global options are documented in Global options.

tlog verify

pond tlog verify

Verify inclusion of every leaf, append-only consistency across every published checkpoint, and faithfulness to the control-table commit spine

Argument / optionAccepted valuesRequiredDefaultDescription
-h, --helpflag (no value)nonot specifiedPrint help

Global options are documented in Global options.

verify

pond verify

Verify local data matches one or more remotes' recorded checksums (D6)

Argument / optionAccepted valuesRequiredDefaultDescription
--exactflag (no value)nofalseExit nonzero unless every remote tip exactly equals the local tip
-h, --helpflag (no value)nonot specifiedPrint help
NAME1 value(s)nonot specifiedRemote or backup name. Omit to verify against every attachment

Global options are documented in Global options.