CLI Companion Episodes

`ed companion episodes`

Lists the most recent episodes ordered by occurrence time.

Usage:

ed companion episodes [--limit <n>] [--json] [--endpoint <url>]

Options:

Name	Type / values	Default	What it does
`--limit`	positive integer	`20`	Asks for this many recent episodes. The API caps it at 200.
`--json`	flag	off	Emits one JSON document on stdout.
`--endpoint`	URL	environment or local default	Uses this Companion API base URL.

--json shape:

[
  {
    "id": "5d4c0ebf-1086-46fb-ab93-dd325ed197f3",
    "kind": "md",
    "occurredAt": "2026-08-09T06:30:00.000Z",
    "sha256": "a46b0c249b09d97a9a2eeb66e995fe56d6513fbb80a4f711f846d6b92e98a1e3",
    "title": "Planning notes"
  }
]

Each item has its episode id, ISO 8601 occurredAt, source kind, display title, and the source content hash in sha256.

Examples:

$ ed companion episodes --limit 3
#  TITLE           KIND  OCCURRED
1  Planning notes  md    2026-08-09T06:30:00.000Z
2  Edith launch    md    2026-08-08T18:10:00.000Z

$ ed companion episodes --limit 50 --json
[
  {
    "id": "5d4c0ebf-1086-46fb-ab93-dd325ed197f3",
    "kind": "md",
    "occurredAt": "2026-08-09T06:30:00.000Z",
    "sha256": "a46b0c249b09d97a9a2eeb66e995fe56d6513fbb80a4f711f846d6b92e98a1e3",
    "title": "Planning notes"
  }
]

Behaviour: this is a read-only GET /v1/episodes. --limit must be greater than zero. The backend returns at most 200 items, and an empty backend returns an empty JSON array or a table header with no rows.