---
source: src/main.rs
assertion_line: 4798
expression: sub.render_long_help().to_string()
---
Fetch a session or message.
`--session-id` returns the whole session as a conversational transcript (user/assistant text + one-line tool/file refs). `--message-id` returns that one message with its full parts (tool bodies included) plus conversational neighbors. Params are prefixed by scope.
Usage: pond get [OPTIONS] <--session-id <ID>|--message-id <ID>>
Options:
--session-id <ID>
Fetch an entire session by id. Mutually exclusive with `--message-id`
--message-id <ID>
Fetch a single message by id (with its full parts). Mutually exclusive with `--session-id`
--namespace <NAMESPACE>
Tenant namespace. The personal pond has exactly one; leave at the default
[default: local]
--session-limit <SESSION_LIMIT>
Session scope: max messages per page
[default: 20]
--session-from <SESSION_FROM>
Session scope: which end to read the first page from.
start = oldest first (default); end = most recent, e.g. to recover context after compaction.
[default: start]
[possible values: start, end]
--session-after-message-id <ID>
Session scope: page forward - messages after this id (from a prior page's bottom marker)
--session-before-message-id <ID>
Session scope: page backward - messages before this id (from a prior page's top marker)
--message-context-before <MESSAGE_CONTEXT_BEFORE>
Message scope: conversational siblings before the target (grep -B)
[default: 3]
--message-context-after <MESSAGE_CONTEXT_AFTER>
Message scope: conversational siblings after the target (grep -A)
[default: 3]
--format <FORMAT>
[default: text]
[possible values: text, json]
-h, --help
Print help (see a summary with '-h')
Global options:
--storage-path <URL>
Storage destination: a local path or remote URL.
Accepts a bare path, `~/path`, `file://`, `s3://bucket/prefix`, `s3+https://host/bucket/prefix`, `gs://`, `az://`, or the keyword `local` (the platform default local data dir). Default: `[storage].path` from config, then the platform data dir (`~/.local/share/pond`).
[env: POND_STORAGE_PATH]
--config-file <PATH>
Config file to read (default: `~/.config/pond/config.toml`)
[env: POND_CONFIG_FILE]
-v, --verbose...
Increase logging verbosity
-q, --quiet...
Decrease logging verbosity
Examples:
pond get --session-id 58a96901-4a4f-40be-a3c1-62419ec8c580
pond get --session-id <ID> --session-from end most recent messages
pond get --session-id <ID> --session-after-message-id <ID> page down
pond get --message-id <ID> --message-context-before 3 --message-context-after 3