About Moxie Docs
Overview
Moxie Docs is an automated documentation service for GitHub repositories. It connects to GitHub, generates docs from source code, and keeps them aligned by re-checking them on every merged pull request. When code changes cause docs to drift, it opens a docs-only pull request that your team reviews before merging — nothing auto-merges.
Every plan includes an MCP server, so AI editors and agents such as Cursor, Claude Code, and Codex pull cited conventions, verified commands, and open gaps instead of re-crawling the repository on every prompt. The service is free forever on one repository with no card required, and paid plans start with a 14-day trial.
Key Benefits
- Generates architecture pages, API references, and convention guides cited to the source files they came from
- Re-checks documentation on every merge and flags affected pages with the exact lines that changed
- Opens docs-only Friday Cleanup PRs on Pro and Team plans that wait for human review
- Serves MCP context to AI agents on every plan, cutting token waste from whole-repo scans
- Publishes a hosted knowledgebase on your-team.moxiedocs.app with human approval before anything goes live
- Limits GitHub App access to only the repositories you select, with secrets skipped at index time
How It Works
Install the scoped GitHub App on the repositories you choose; the rest of your organization stays invisible to Moxie. The first index is a full baseline, after which each merge re-checks the affected surface incrementally. On every pull request, Moxie posts advisory checks for description alignment, documentation drift, and conventions, and on Pro and Team plans it batches leftover drift into a weekly Friday Cleanup PR for your review.
Use Cases
- Solo developers use the free tier to keep one repository's docs current forever
- Engineering teams require Moxie PR checks in branch protection to gate merges
- AI-assistant users query the MCP server for cited conventions instead of re-reading files
- Product teams publish plain-language help articles for end users through the knowledgebase
- Open-source maintainers can request free access for their projects
- Organizations with fleets of services use Team plans for priority indexing and unlimited seats
Why Choose This Product
Moxie's trust boundaries are explicit: it reads code to write docs and serve context, proposes changes only as docs-only pull requests, and never rewrites application code or trains models on customer code. Security practices include encrypted tokens at rest and ignored paths for generated folders and vendored dependencies. Production figures reported on the site include 500+ repositories connected and 88% of reviewed doc PRs merged.
Moxie Docs Pros & Cons
- Free forever on one repository with no card required
- Docs-only pull requests always require human review
- MCP context endpoint included on every plan
- Scoped GitHub App access limited to selected repositories
- 500+ repositories connected and 88% of reviewed doc PRs merged
- No pay-as-you-go SKU today
- Custom knowledgebase domains are coming soon on Pro and Team plans
- Friday Cleanup automation requires a Pro or Team plan
Key Features
Source-cited doc generation
Indexes a repository and generates architecture pages, API references, and convention summaries with citations back to the source files they came from.
Drift detection
Re-checks documentation on every merged pull request, flags affected pages, and regenerates stale docs with cited diffs showing what changed.
Friday Cleanup
Pro+Batches stale pages, gaps, and drift into a single weekly docs-only pull request your team reviews, with nothing auto-merging.
MCP context server
All plansExposes current docs, conventions, verified commands, and open gaps to MCP-compatible agents through /api/mcp with OAuth or bearer-token access.
GitHub PR checks
Posts advisory Description, Documentation, and Conventions checks on each PR; teams can require them in branch protection to gate merges.
Hosted knowledgebase
Publishes a searchable help center on a moxiedocs.app subdomain with article search, a changelog, llms.txt, and human review before anything goes public.
Multi-language recognition
Recognizes TypeScript, JavaScript, Python, Go, Rust, Ruby, Java, PHP, SQL, Svelte, Vue, Kotlin, Swift, Elixir, and Zig, with deepest symbol and import analysis for TS/JS and Python.
Scoped GitHub access
Connects through a per-repo GitHub App, encrypts tokens at rest, and skips environment files, keys, and vendored folders at index time.
Priority indexing
TeamRuns on a priority queue so larger fleets get faster re-indexing after merges.
Moxie Docs Pricing
View full pricing →- 1 repository, no card required
- 1 seat
- ~500 indexed files per repo
- 2 Cleanup PRs per month
- 5 search Q&A questions per month
- 10 PR-review-runs per month
- Up to 5 active private repositories
- 1 seat
- 2,000 indexed files per repo
- 10 doc update PRs per repo each month
- Up to 15 active private repositories
- 10 seats
- 5,000 indexed files per repo
- Weekly Friday Cleanup with automated Cleanup PR drafts
- Up to 50 active private repositories
- Unlimited team seats
- 15,000 indexed files per repo
- Weekly Friday Cleanup
- Priority indexing queue
| Feature | Free Free | Starter $29/mo | Pro $79/mo | Team $199/mo |
|---|---|---|---|---|
| Friday Cleanup | ||||
| MCP context server | ||||
| Priority indexing |
Pricing extracted from the product website and may change. Check the source for current details.
Frequently asked questions about Moxie Docs
Does Moxie Docs work with private GitHub repositories?
Yes, it is built for private repos. The GitHub App is scoped to only the repos you choose, tokens are encrypted server-side, and code is used only to generate documentation and MCP context for your workspace.
What programming languages does Moxie Docs support?
Documentation and search work with any GitHub repository. Moxie recognizes TypeScript, JavaScript, Python, Go, Rust, Ruby, Java, PHP, SQL, Svelte, Vue, Kotlin, Swift, Elixir, and Zig, with the deepest structured convention analysis (symbol and import graphs) for TypeScript, JavaScript, and Python.
How much does automated codebase documentation cost?
Starter is $29/month, Pro is $79/month, and Team is $199/month, each with a 14-day free trial. Annual billing saves about two months versus monthly. A free tier covers one repository forever with no card required, and a one-time $5 pass unlocks two weeks of Pro.
Do PR checks block merge, or only warn?
By default Moxie posts advisory check runs so findings stay visible without blocking the team. You can require the Moxie Docs checks in GitHub branch protection or rulesets to turn a warning into a gate.
Will Moxie Docs change my application code automatically?
No. Moxie only proposes documentation changes as reviewable pull requests. Description alignment may update a pull request description on GitHub, but your source code, branch protection, and merge controls stay with your team.
Can I pay annually, and is there a discount?
Yes. Every plan can be billed monthly or annually, and annual billing is two months free (about 17% off). Annually, Starter is $290/year, Pro is $790/year, and Team is $1,990/year. You can switch between monthly and annual billing anytime from the billing portal.
How Moxie Docs compares
Moxie DocsThis | ||||
|---|---|---|---|---|
| Starting price | Free | Free | — | $9.50/mo |
| Pricing model | Freemium | Freemium | unknown | Freemium |
| Platforms | Web | — | — | Web |
| Top features |
|
|
|
|
| Rating | — | — | — | — |
