For people
A searchable place to learn the codebase, save context, and understand why files are organized the way they are.
Product workflow
From a GitHub repo to docs that keep up.
Set up in minutes. Then Moxie runs on your cadence: every PR checked, every merge re-indexed, every Friday cleaned up.
The cadence
Once
Connect, start the trial, run the first index.
Every PR & merge
Advisory PR checks, drift detection, re-index.
Every Friday
One reviewable docs-only PR - never auto-merged.
Phase 1 · Once
Setup takes one sitting.
01
Connect GitHub
Install the GitHub App on the repos you choose.
Install Moxie GitHub App
github.com- jackalope/api Selected
- jackalope/web Selected
- jackalope/infraNot selected
Never commits your code · scoped to the repos you pick
02
Start the trial
Add payment details to unlock indexing.
14-day trial
billing$0due today
- First charge after 14 days
- Cancel anytime before renewal
03
Run the first index
Moxie reads source, tests, docs, and history, then writes architecture pages, conventions, gap reports, and MCP context.
First index
jackalope/apireading source · tests · docs · history
- Architecture pages24 docs
- Conventions12 rules
- Doc gaps3 found
- MCP endpointlive
Phase 2 · Every merge
Then it runs on every pull request.
04
Description aligned
Each PR description is rewritten against your template and conventions.
#491 MCP tool: search_docs
opened by @lexbefore
added search tool, misc fixes
after
Adds the search_docs MCP tool. Queries hit the doc index and return cited matches. Why: agents needed scoped search…
Description alignedDiff untouched
05
Doc impact flagged
Advisory check runs call out stale or missing docs on the PR while fixing is cheap. Require Moxie Docs / Documentation in branch protection if you want a hard gate.
Doc-impact check
#491 · pre-merge- docs/mcp-tools.mdMissing: search_docs
- docs/architecture/search.mdStale section
Advisory PR check. Fix now or let Friday Cleanup catch it
06
Drift caught on merge
When code lands, affected docs are re-checked and refreshed, cited back to source. RFCs citing never-built paths are not treated as deletions. Repo doc PRs wait for Friday.
Merge detected
#491 · main Drift · docs/architecture/search.md Regenerated
- Search runs against raw file chunks.
+ Search queries the doc index via the search_docs MCP tool.
Re-indexed 4m after merge · cited to source
Phase 3 · Every Friday
Fridays close the loop.
07
One docs-only PR
Moxie recaps the week's merges and opens a single reviewable PR for anything documentation missed.
Friday Cleanup
Week of Jun 1 · 9 PRs mergedDocs: catch up on this week's merges
moxie/friday-cleanup · docs-only · awaiting your review
- docs/mcp-tools.md+18 −2
- docs/billing.md+12 −4
Docs-onlySource-citedAwaiting review
Merge it, edit it, or close it. Your call.
Human and AI use
The same index supports readers, reviewers, and agents.
For agents
A compact context layer with conventions, commands, boundaries, and citations before AI tools edit the repo.
Phase 1 starts whenever you do.
Connect a repo and the first index runs in minutes.