Your AI chat logs, finally turned into a wiki

What it does

CodeAlmanac maintains a local wiki inside your repository’s almanac/ directory, using AI agents to turn raw code, diffs, PRs, and chat transcripts into plain markdown pages. The result is searchable, browsable context that lives in Git alongside your source code, meant to answer why things are built a certain way rather than simply how.

The interesting bit

The project treats documentation as a background chore for AI agents, not humans. Local launchd jobs on macOS silently scan your Codex and Claude transcripts, automatically extracting durable knowledge and cleaning up stale or duplicate pages. Everything stays offline: the index, the viewer, and the agent harness all run locally, with no hosted service involved.

Key highlights

• Plain markdown output in an almanac/ folder, versioned like any other code.
• ingest and garden lifecycle agents fold external material into the wiki and prune stale or duplicated content.
• Read-only local web viewer with search, topics, and backlink navigation.
• Reuses your existing Codex or Claude Code OAuth sessions; no separate API keys required unless embedding the SDK.
• Telemetry is optional but enabled by default; the project claims it never transmits code, paths, queries, or credentials—only sanitized crash reports and command outcomes.

Caveats

• macOS-only support at the moment, and it requires Python 3.12+.
• Lifecycle agents are trusted local processes with broad filesystem access; the almanac/ directory boundary is a policy, not a security sandbox.
• Read commands work without credentials, but any write-capable lifecycle command needs a working, authenticated Codex or Claude harness.

Verdict

Worth a look if you are already heavy into Codex or Claude Code and tired of repeating context across chat sessions. Skip it if you are on Linux or Windows, or if you prefer to keep AI agents far away from your Git history.