@kimbho/kimbho-cli 0.1.20 → 0.1.21

package/README.md

@@ -30,9 +30,15 @@ npm install -g ./kimbho-kimbho-cli-<version>.tgz
 ```bash
 kimbho
 kimbho shell
+kimbho "explain this repo"
+kimbho exec --json "explain this repo"
+kimbho completion bash
 kimbho --help
 kimbho init
 kimbho plan "build a coding agent"
+kimbho fork --last
+kimbho resume --list
+kimbho -c 'approvalMode="auto"' -c 'brains.coder.providerId="echo"' "hello"
 kimbho /models openrouter --search claude --limit 10
 ```
 
@@ -81,7 +87,7 @@ LM Studio example:
 
 `run` now auto-executes the supported ready-task frontier and persists session events. Specialist tasks are executed through a bounded model-driven tool loop that can list files, search source contents, read files, write files, apply patches, inspect git diff, run verification commands, and emit resumable transcripts. `resume --execute` continues that frontier from the latest session snapshot.
 Kimbho also has repo intelligence tools (`repo.index`, `repo.query`) so agents can reason over symbols, routes, schemas, packages, and import edges instead of relying only on raw file reads.
-For empty workspaces, Kimbho now has deterministic scaffold presets for `static-landing`, `node-cli-typescript`, `next-prisma-postgres`, and `kimbho-cli-monorepo`, so the scaffold task can generate a real starter app without needing preexisting repo state or a prior `.kimbho/config.json`.
+For empty workspaces, Kimbho now has deterministic scaffold presets for `static-landing`, `node-cli-typescript`, `next-prisma-postgres`, and `kimbho-cli-monorepo`, so the scaffold task can generate a real starter app without needing preexisting repo state or a prior `.kimbho/config.toml`.
 For existing repositories, specialists now preload deterministic repo context before the first model action: `repo.index`, `repo.query`, and a small set of repo-defining file reads are injected automatically into the transcript and prompt context.
 When resuming the current saved session, that saved session context is also injected into the next specialist run so the model does not restart from zero.
 After the agent changes workspace state, it now has to pass a verification step before the task can finish.
@@ -106,9 +112,17 @@ kimbho run "fix the failing test suite" --max-agent-steps 10 --max-repair-attemp
 kimbho resume --execute --max-auto-tasks 2 --max-repair-attempts 3
 ```
 
+Useful parity-oriented flags:
+
+```bash
+kimbho --profile local-dev "summarize this repo"
+kimbho -c 'sandboxMode="read-only"' exec --output-format json "explain the current diff"
+kimbho --add-dir ../shared-lib --full-auto run "wire the shared package into this app"
+```
+
 ## Notes
 
 - The published CLI bundles the internal Kimbho packages so installation does not depend on the monorepo layout.
-- Brain and provider configuration is stored in `.kimbho/config.json`.
+- Brain and provider configuration is stored in `.kimbho/config.toml` with optional `.kimbho/config.local.toml` overrides.
 - Use `kimbho models use <model> --provider <id> --set-default` to select a provider model for the whole system.
 - Use `kimbho brains assign --role <role> ...` only when you intentionally want an advanced per-role override.