Skip to content

init

Set up doraval together with the Agent Journal and configure which coding agent doraval should use when enriching journal entries.

Terminal window
doraval init [options]

init performs several one-time steps. The interactive CLI now clearly labels them:

  1. Journal setup – repository, project name, and fetching.
  2. Agent configuration – choose and configure your coding agent (Claude, Cursor, etc.).
  3. Eval configuration – optional model for dora eval.

Details:

  • Ensures the GitHub CLI (gh) is available and authenticated.
  • Prompts for (or accepts via flags/env) your journal repository.
  • Prompts for a project name (defaults to the current directory).
  • Configures a coding agent command and prompt template so that doraval journal add can automatically enrich entries with tags and rationale.
  • Creates local cache directories under ~/.doraval/.
  • Fetches the relevant journal files from GitHub.
FlagDescription
-r, --repoJournal repository (owner/name). Smart default from git remote or gh account. Env: DORAVAL_JOURNAL_REPO
-p, --projectProject name (defaults to basename of current directory)
--refreshRe-fetch journal files even if the project is already registered
Terminal window
doraval journal init --repo yourname/yourname.md --project my-project

Or with environment variables:

Terminal window
DORAVAL_JOURNAL_REPO=yourname/yourname.md \
DORAVAL_PROJECT=my-project \
doraval init

Use the journal commands to work with your decisions:

  • doraval journal list
  • doraval journal add "..." (can use the configured agent to help)
  • doraval journal update
  • doraval journal sync

See the Agent Journal concept page for the broader picture.