Repository navigation
fix: make the README's CLI paths work from a fresh clone - #22
Merged
Merged
Conversation
…, tamper GIF - One-line pitch: tamper-evident, SHA-256-chained ledger for AI agents - 30-second quickstart: build korg-verify, verify a real session ledger, rewrite one event, watch the verifier name it (run verbatim from a fresh clone; cold build ~10s) - tamper.gif + tamper.tape: real korg-verify run catching a one-line edit - "Validated across three vendors (N=3)" table: Claude Code, Codex CLI, Grok Heavy adapters with their passing test counts - Add LICENSE-APACHE and fix the README license links (LICENSE-MIT and LICENSE-APACHE were dead links; Cargo.toml already declares MIT OR Apache-2.0) - Drop the stale "175 tests" badge (Status section reports 300+) Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01CT1ehtuNDw4s9khDS3TBtq
Found by running every README command from a clean checkout: - korg rewind on an empty journal printed a raw anyhow error (and a full stack trace under RUST_BACKTRACE). It now explains that nothing has been recorded yet and points at `korg --goal` / `korg demo`; exits 1 either way. - Swarm workers failed with "cannot force update the branch 'korg-branch-pkg-*'" after any interrupted run: the harness deleted the stale worktree directory but git still held the branch. Run `git worktree prune` before `worktree add -B`. - The committed korg.toml set default_llm = "ollama", so `korg --goal` run inside this repo tried localhost:11434 even though --help and the README say the default is the hermetic deterministic provider. Default it to "deterministic"; `--provider ollama` still opts in. - demo.tape: the rewind step targeted a journal that does not exist on a fresh clone, and the outro advertised `cargo install korg` (not on crates.io). The tape now seeds a real journal with a hidden campaign on the fixture repo, rewinds it, and ends with the clone+build command. demo.gif/mp4/webp re-rendered. - README: note that rewind needs a populated journal and that --goal runs a real per-persona cargo check (minutes on a large repo). Verified: cargo test --workspace (299 passed), clippy correctness gate, cargo fmt --check, and a full `korg --goal` campaign to completion on both the fixture repo (55s) and this repo. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01CT1ehtuNDw4s9khDS3TBtq
New1Direction
added a commit
that referenced
this pull request
Oct 5, 2026
Bump the korg runtime crates from 0.1.0 to 0.2.0 (korg-bridge keeps its own bridge-v* line) and cut the [0.2.0] changelog section from Unreleased, filling in the merged work it was missing (#8-#22). Claude-Session: https://claude.ai/code/session_01QsuMoxNk88vZYnxPepuUKV Co-authored-by: Claude <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Follow-up to #21. I ran every command in the README from a clean checkout and fixed the ones that broke.
Fixes
korg rewindon an empty journal: it printed a rawanyhowerror, plus a full stack trace whenRUST_BACKTRACEwas set. It now says nothing has been recorded yet and points tokorg --goal/korg demo. It still exits 1.git worktree add -B korg-branch-pkg-*failed withcannot force update the branch … used by worktree. The harness had deleted the stale worktree directory, but git still had it registered. It now runsgit worktree prunefirst.korg --goalinside this repo called Ollama: the committedkorg.tomlhaddefault_llm = "ollama", but--helpand the README say the default is the offline deterministic provider. The default is nowdeterministic;--provider ollamastill opts in.demo.tape: the rewind step pointed at a journal that doesn't exist on a fresh clone, and the last line advertisedcargo install korg, which isn't on crates.io. The tape now creates a real journal with a hidden campaign onfixtures/honest-demo-repo, rewinds it (32 → 5 events), and ends with the clone + build command.demo.gif/demo.mp4/demo.webpre-rendered.--goalruns a realcargo checkper persona, which takes minutes on a large repo.Verification
cargo test --workspace --no-fail-fast: 299 passed, 0 failedcargo fmt --check: cleankorg --goalcampaign ran to completion (exit 0) on the fixture repo (55s) and on this repo (cold, about 8 min)🤖 Generated with Claude Code
https://claude.ai/code/session_01CT1ehtuNDw4s9khDS3TBtq
Generated by Claude Code