Command reference¶

Every command and flag of the two command-line tools, generated from their code.

• jezero: the server, its maintenance commands and the commands for people (installed with the package).
• jezero_client.py: the client core that every plugin carries (one Python file, standard library only).

Contents¶

• jezero: ui, find, show, agents, connect, init, check-config, stats, search, import-jsonl, new-token, run, redact-stored, device, connector, resummarize, retag, health, serve
• jezero_client.py: init, status, setup, mcp, hook, flush, backfill, protocol

jezero¶

Command line interface: jezero <command>.

Global options, before the command:

Without a command, in a terminal, jezero opens the app.

jezero ui¶

Open the Jezero app (also: jezero with no command).

jezero ui [-h] [--demo]

jezero find¶

Search Jezero with this computer's key, like an agent.

jezero find [-h] [--project PROJECT] [--limit LIMIT] [--demo] query [query ...]

jezero show¶

One memory in full; --newer checks if it changed later.

jezero show [-h] [--newer] [--demo] id

jezero agents¶

Which agents on this computer use Jezero.

jezero agents [-h] [--demo]

jezero connect¶

Create this computer's key (asks what it needs).

jezero connect [-h] [--url URL] [--device DEVICE] [--read-only] [--force]

jezero init¶

Create or verify the database.

jezero init [-h]

jezero check-config¶

Validate the config and report missing env vars.

jezero check-config [-h]

jezero stats¶

Item counts per source.

jezero stats [-h]

jezero search¶

Search from the terminal (admin: sees every source).

jezero search [-h] [--source SOURCE] [--project PROJECT] [--limit LIMIT] query

jezero import-jsonl¶

Import pre-summarised items from a JSONL file.

jezero import-jsonl [-h] --source SOURCE [--project PROJECT]
                           [--trust {own,external}]
                           path

jezero new-token¶

Generate a client token and its SHA-256 digest.

jezero new-token [-h]

jezero run¶

Run connectors once: collect, summarise, store.

jezero run [-h] [--connector CONNECTOR] [--limit LIMIT] [--sample SAMPLE]
                  [--dry-run] [--due]

jezero redact-stored¶

Apply the current redaction rules to stored items.

jezero redact-stored [-h] [--dry-run]

jezero device¶

Devices that upload sessions (Jezero plugins).

jezero device [-h] {approve,list,revoke,rotate} ...

jezero device approve¶

Accept a device key printed by jezero_client init.

jezero device approve [-h] [--sources SOURCES [SOURCES ...]]
                             [--source-prefix SOURCE_PREFIX] [--read-only]
                             name digest

jezero device list¶

List clients: devices and token_env clients.

jezero device list [-h] [--json]

jezero device revoke¶

Remove a client's key; its inbox connectors are disabled, stored items kept.

jezero device revoke [-h] [--remove-connectors] name

jezero device rotate¶

Replace a device key; the old key stops working.

jezero device rotate [-h] name digest

jezero connector¶

Inspect connectors or make one read its source again.

jezero connector [-h] {list,reset} ...

jezero connector list¶

Connectors with last run, last success, error and items.

jezero connector list [-h] [--json]

jezero connector reset¶

Forget a connector's cursor so its next run reads the source from the start; stored items are kept and unchanged ones are skipped by content hash (no LLM calls).

jezero connector reset [-h] [--yes] name

jezero resummarize¶

Summarise stored items again from their original.

jezero resummarize [-h] [--ids IDS] [--ids-file IDS_FILE]

jezero retag¶

Re-apply project hints from the source, without the LLM.

jezero retag [-h] --connector CONNECTOR [--dry-run]

jezero health¶

Report stale or failing connectors (exit 1 if any); alert if set.

jezero health [-h]

jezero serve¶

Run the MCP server.

jezero serve [-h]

jezero_client.py¶

Jezero client: shared core of the Jezero plugins. Run it with python3; it needs Python 3.9 or newer and nothing else. See the client reference for its files and environment variables.

jezero_client.py init¶

Create this device's key.

jezero_client init [-h] --url URL --device DEVICE [--force] [--no-upload]
                          [--mcp-path MCP_PATH]

jezero_client.py status¶

Check the key with the server and show the queue.

jezero_client status [-h]
                            [--agent {claude-code,codex,opencode,hermes,antigravity}]

jezero_client.py setup¶

Register the Jezero MCP server in the agents.

jezero_client setup [-h]
                           [--agent {claude-code,codex,opencode,hermes,antigravity}]
                           [--opencode-plugin OPENCODE_PLUGIN]

jezero_client.py mcp¶

Stdio MCP server that forwards to Jezero with this key.

jezero_client mcp [-h]
                         [--agent {claude-code,codex,opencode,hermes,antigravity}]

jezero_client.py hook¶

Run a hook (reads the agent's JSON on stdin).

jezero_client hook [-h] --agent {claude-code,codex,opencode,hermes,antigravity}
                          {session-start,user-prompt,stop,session-end}

jezero_client.py flush¶

Upload queued sessions now.

jezero_client flush [-h]
                           [--agent {claude-code,codex,opencode,hermes,antigravity}]

jezero_client.py backfill¶

Queue sessions already on this computer.

jezero_client backfill [-h]
                              [--agent {claude-code,codex,opencode,hermes,antigravity}]
                              [--days DAYS] [--hermes-home HERMES_HOME]

jezero_client.py protocol¶

Print the instructions given to agents.

jezero_client protocol [-h]