// FAQ

Frequently asked questions

Everything about how Moxie Docs documents your codebase, keeps it current, secures your GitHub access, and serves context to AI agents over MCP.

Getting started

What is Moxie Docs?

Moxie Docs is a hosted service that connects to your GitHub repositories, generates a searchable knowledge base of your codebase, keeps it in sync as code changes, and serves that context to AI coding agents over the Model Context Protocol (MCP). It documents architecture, conventions, and key modules automatically, and proposes documentation updates as pull requests your team reviews.

Who is Moxie Docs for?

Engineering teams that want living documentation without writing it by hand: solo builders documenting private repos, growing teams onboarding new engineers, and organizations maintaining a fleet of services. It is also for teams that want their AI coding agents to have accurate, current context about their codebase.

How do I get started?

Start a 14-day trial, connect your GitHub account through the Moxie Docs GitHub App, and select the repositories you want documented. Moxie indexes a real repository and generates docs, search, gap detection, and MCP context during the trial. No charge today, and you can cancel anytime before the trial ends.

How it works

How does Moxie Docs generate documentation?

Moxie indexes the source files in the repositories you select, builds an outline of the codebase, and generates documentation page by page — architecture overviews, references, and conventions — grounded in your actual code. Documentation is regenerated incrementally as code changes, so it stays current instead of going stale.

Does Moxie Docs keep documentation up to date when code changes?

Yes. When pull requests merge, Moxie detects which documentation is affected, updates the impacted pages, and flags documentation drift and gaps. On Pro and Team plans it also runs a weekly Friday Cleanup that opens documentation pull requests for your team to review.

Does Moxie Docs merge changes to my repository?

No. Moxie Docs only ever proposes documentation changes as pull requests. Your team reviews and merges every one — Moxie never merges anything itself.

What programming languages does Moxie Docs support?

Documentation and search work with any GitHub repository, with first-class file recognition for all major languages including TypeScript, JavaScript, Python, Go, Rust, Ruby, Java, PHP, SQL, Svelte, and Vue. Structured convention and dependency analysis is deepest for TypeScript/JavaScript, Python, Go, Rust, and Ruby.

AI agents & MCP

Can AI coding agents use Moxie Docs?

Yes. Every plan includes an MCP (Model Context Protocol) context endpoint, so MCP-compatible agents and editors can pull your repository's current documentation, conventions, and context while they work — keeping their output consistent with how your codebase actually works.

What is the MCP context endpoint?

It is a Model Context Protocol server that exposes your repository's documentation and conventions to AI agents and editors that support MCP. Agents query it for up-to-date context instead of guessing, which reduces hallucinated APIs and off-convention code.

GitHub access & security

What access does Moxie Docs need to my GitHub repositories?

Moxie Docs connects through a GitHub App scoped to only the repositories you select, and reads those repositories to generate documentation, gaps, search, and MCP context. Documentation changes are only ever proposed as pull requests — Moxie never merges anything itself.

Does Moxie Docs work with private repositories?

Yes. Moxie Docs is built for private repositories. The GitHub App is scoped to only the repos you choose, and your code is used solely to generate documentation and context for your workspace.

Pricing & plans

How much does Moxie Docs cost?

Moxie Docs has three plans. Starter is $29/month ($290/year), Pro is $79/month ($790/year), and Team is $199/month ($1,990/year). Every plan starts with a 14-day free trial.

How does the 14-day trial work?

Start a trial on any plan with no charge today. Connect GitHub, index a real repository, and use the generated docs, search, gap detection, and MCP context for 14 days. Cancel anytime before the trial ends and you won't be billed.

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) versus paying monthly. Annually, Starter is $290/year, Pro is $790/year, and Team is $1,990/year. You can switch between monthly and annual anytime from the billing portal.

What is the difference between the Starter, Pro, and Team plans?

Starter fits a solo builder: up to 5 active private repositories and 1 seat. Pro fits a growing team: up to 15 repositories, 10 seats, weekly Friday Cleanup, and automated Cleanup PR drafts. Team fits an organization: up to 50 repositories, unlimited seats, priority indexing, and everything in Pro.

Can I cancel anytime?

Yes. You can cancel or change your plan anytime from the billing portal. Cancel before your 14-day trial ends and you won't be charged.

Still have a question?

Start a 14-day trial on a real repo, or reach out and we'll help you scope it.