Product workflow

From a GitHub repo to docs that keep up.

One afternoon of setup, then Moxie works on your repo's schedule: every pull request checked, every merge re-indexed, every Friday cleaned up.

The cadence

Once

Connect, start the trial, run the first index.

Every merge

PR checks, drift detection, re-index.

Every Friday

One reviewable docs-only PR.

Phase 1 · Once

Setup takes one sitting.

01

Connect GitHub

Install the GitHub App on the repos you choose. Read-only by default, scoped per repository.

Install Moxie GitHub App
github.com
  • jackalope/api Selected
  • jackalope/web Selected
  • jackalope/infraNot selected

Read-only access · scoped to the repos you pick

02

Start the trial

Add payment details to unlock indexing. 14 days, no charge today, cancel anytime.

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 — and writes architecture pages, conventions, gap reports, and MCP context.

First index
jackalope/api

reading 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. The diff is never touched.

#491 MCP tool: search_docs
opened by @lex

before

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

Stale or missing docs are called out on the PR — before merge, while fixing is cheap.

Doc-impact check
#491 · pre-merge
  • docs/mcp-tools.mdMissing: search_docs
  • docs/architecture/search.mdStale section

Flagged on the PR — fix now or let Friday Cleanup catch it

06

Drift caught on merge

When code lands, the affected docs are re-checked and regenerated, cited back to source.

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. You review, you merge — nothing lands on its own.

Friday Cleanup
Week of Jun 1 · 9 PRs merged
Docs: 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 people

A searchable place to learn the codebase, save context, and understand why files are organized the way they are.

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.