init
Set up doraval together with the Agent Journal and configure which coding agent doraval should use when enriching journal entries.
doraval init [options]What it does
Section titled “What it does”init performs several one-time steps. The interactive CLI now clearly labels them:
- Journal setup – repository, project name, and fetching.
- Agent configuration – choose and configure your coding agent (Claude, Cursor, etc.).
- 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 addcan automatically enrich entries with tags and rationale. - Creates local cache directories under
~/.doraval/. - Fetches the relevant journal files from GitHub.
Options
Section titled “Options”| Flag | Description |
|---|---|
-r, --repo | Journal repository (owner/name). Smart default from git remote or gh account. Env: DORAVAL_JOURNAL_REPO |
-p, --project | Project name (defaults to basename of current directory) |
--refresh | Re-fetch journal files even if the project is already registered |
Non-interactive usage
Section titled “Non-interactive usage”doraval journal init --repo yourname/yourname.md --project my-projectOr with environment variables:
DORAVAL_JOURNAL_REPO=yourname/yourname.md \DORAVAL_PROJECT=my-project \doraval initAfter init
Section titled “After init”Use the journal commands to work with your decisions:
doraval journal listdoraval journal add "..."(can use the configured agent to help)doraval journal updatedoraval journal sync
See the Agent Journal concept page for the broader picture.
See also
Section titled “See also”- journal init: lower-level journal-only setup
- Agent Journal