codealmanac 0.2.3 → 0.2.4

package/README.md

@@ -43,6 +43,7 @@ codealmanac --yes
 
 `codealmanac` (the bare invocation) routes to a setup wizard that:
 - lets you choose a default agent: Claude, Codex, or Cursor,
+- lets you choose a provider model or inherit the provider default,
 - checks local agent readiness,
 - installs auto-capture hooks for Claude, Codex, and Cursor,
 - drops two agent guides into `~/.claude/` (`codealmanac.md` mini, `codealmanac-reference.md` full),
@@ -78,17 +79,23 @@ almanac doctor
 Set or change the default at any time:
 
 ```bash
-almanac set default-agent codex
-almanac set model codex gpt-5.3-codex
+almanac agents use codex
+almanac agents model codex gpt-5.3-codex
+
+# Scriptable equivalent:
+almanac config set agent.default codex
+almanac config set agent.models.codex gpt-5.3-codex
+almanac config set --project agent.default claude
 ```
 
 codealmanac itself never stores your provider credentials. Auth stays in each agent's normal local credential store.
+User config lives in `~/.almanac/config.toml`; project agent defaults can live in `.almanac/config.toml`.
 
 ## Quickstart
 
 ```bash
 npm install -g codealmanac
-codealmanac                   # interactive setup wizard; choose Claude/Codex/Cursor
+codealmanac                   # interactive setup wizard; choose provider + model
                               # (or: codealmanac --yes)
 
 cd your-repo
@@ -117,7 +124,7 @@ almanac search --topic database              # filter by topic
 almanac search --mentions src/lib/stripe.ts  # pages referencing a file
 almanac show checkout-flow                   # read a page
 almanac show checkout-flow --meta            # metadata only
-almanac show checkout-flow --raw             # body only
+almanac show checkout-flow --body            # body only
 
 # Organize
 almanac topics list                          # all topics with page counts
@@ -128,16 +135,22 @@ almanac health                               # graph integrity report
 # Wiki lifecycle
 almanac bootstrap --agent codex              # seed a new wiki from the repo
 almanac capture --agent cursor <transcript>  # update wiki from a transcript
+almanac capture --json <transcript>          # structured CommandOutcome output
 almanac hook install --source all            # auto-capture for Claude/Codex/Cursor
 
 # Setup & diagnose
 almanac agents list                          # provider readiness + default
-almanac set default-agent codex              # change default provider
+almanac agents use codex                     # change default provider
+almanac agents model claude claude-opus-4-6  # set provider model
+almanac config list --show-origin            # scriptable settings view
 almanac doctor                               # check install + wiki health
 almanac update                               # update to latest version
 ```
 
-All commands output slugs one per line. Add `--json` for structured output. Pipe with `--stdin`:
+`bootstrap` and `capture` resolve provider settings in the standard order:
+`--agent` / `--model`, then `ALMANAC_AGENT` / `ALMANAC_MODEL`, then config.
+
+All query commands output slugs one per line. Add `--json` for structured output. Pipe with `--stdin`:
 
 ```bash
 almanac search --topic flows | almanac show --stdin

package/dist/agents-4Y7X24WW.js

@@ -0,0 +1,25 @@
+#!/usr/bin/env node
+import {
+  runAgentsDoctor,
+  runAgentsList,
+  runAgentsModel,
+  runAgentsUse,
+  runDeprecatedSetAgentModel,
+  runDeprecatedSetDefaultAgent,
+  runSetAgentModel,
+  runSetDefaultAgent
+} from "./chunk-UU6FBRQO.js";
+import "./chunk-BF2J4XTC.js";
+import "./chunk-P5WGG4FJ.js";
+import "./chunk-7JUX4ADQ.js";
+export {
+  runAgentsDoctor,
+  runAgentsList,
+  runAgentsModel,
+  runAgentsUse,
+  runDeprecatedSetAgentModel,
+  runDeprecatedSetDefaultAgent,
+  runSetAgentModel,
+  runSetDefaultAgent
+};
+//# sourceMappingURL=agents-4Y7X24WW.js.map