journal list

Show the active entries from your local journal cache.

doraval journal list

By default it shows only status: active entries for the project mapped to your current working directory.

Options

Flag	Description
-p, --project	Project name (defaults to directory-based mapping)
--all	Include non-active entries (superseded, retired)
-f, --format	table (default, human output to stderr) or json (to stdout)

Output

Human output (to stderr) is color-coded by pushback intensity:

• Green (1–3): Nudge
• Yellow (4–6): Friction
• Red (7–10): Wall

JSON output (stdout) is machine readable:

{
  "project": "doraval",
  "entries": [
    {
      "title": "Use \"drift\" not \"score\" for rubric deviation",
      "pushback": 7,
      "tags": ["naming", "cli"],
      "author": "human",
      "date": "2026-05-25",
      "status": "active"
    }
  ]
}

Keeping content fresh

list reads from the local cache at ~/.doraval/journals/. If you suspect the cache is stale (e.g. after another person or machine added entries), run:

doraval journal update

before list.

See journal update for details.

Related

• journal update — refresh the local cache from the remote
• journal add — propose new entries
• journal sync — publish pending entries

See the Agent Journal concept for the big picture.