Shared CLI option plumbing: turning --flag value maps into an engine config,
resolving the default runs dir, and the always-visible spend line. Used by the
agentcli command surface and the codebrain product surface. Deliberately
dependency-light (no command/dispatch code, no session/resume/inspect) so it
can sit underneath both without a cycle.
Shared CLI option plumbing: turning `--flag value` maps into an engine config, resolving the default runs dir, and the always-visible spend line. Used by the `agentcli` command surface and the `codebrain` product surface. Deliberately dependency-light (no command/dispatch code, no `session`/`resume`/`inspect`) so it can sit underneath both without a cycle.
(default-runs-dir)Where runs live when neither --runs-dir nor an explicit dir is given. Mirrors
how git and bd find their data dir: if a .fractal/ already exists in the
current directory or any ancestor, reuse it; otherwise default to .fractal in
the current directory (created on first write). So fractal works wherever you
invoke it, and from a subdirectory it still finds the project's runs. Override the
location per-invocation with --runs-dir DIR.
Where runs live when neither `--runs-dir` nor an explicit dir is given. Mirrors how git and `bd` find their data dir: if a `.fractal/` already exists in the current directory or any ancestor, reuse it; otherwise default to `.fractal` in the current directory (created on first write). So `fractal` works wherever you invoke it, and from a subdirectory it still finds the project's runs. Override the location per-invocation with `--runs-dir DIR`.
(usage-line dir)A compact, always-visible spend summary read from the materialized usage.edn — the answer to runaway worry is seeing the numbers, not capping them.
A compact, always-visible spend summary read from the materialized usage.edn — the answer to runaway worry is seeing the numbers, not capping them.
cljdoc builds & hosts documentation for Clojure/Script libraries
| Ctrl+k | Jump to recent docs |
| ← | Move to previous article |
| → | Move to next article |
| Ctrl+/ | Jump to the search field |