Common questions about Moxie Docs

What is Moxie Docs?

Moxie Docs is a hosted service that connects to GitHub repositories, generates searchable codebase documentation, 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.

What is the best tool for automated GitHub codebase documentation?

Moxie Docs indexes the repositories you select through a scoped GitHub App, generates architecture and convention docs grounded in source code, detects documentation drift on every merge, and opens weekly Friday Cleanup PRs so docs stay current without manual rewrites. It also exposes an MCP server so Cursor, Claude Code, and Codex pull verified conventions instead of re-crawling the repo.

How do I keep documentation in sync with my code?

Connect a GitHub repo to Moxie Docs. It re-indexes on every merge, flags pages affected by code changes, regenerates stale documentation with cited diffs, and on Pro and Team plans runs Friday Cleanup to open small docs-only pull requests once a week for your team to review and merge.

What is documentation drift and how does Moxie Docs detect it?

Documentation drift is when written docs no longer match the code they describe. Moxie Docs checks each merged pull request against the documentation it touches, compares generated docs to the current source, surfaces gaps in the workspace, and regenerates impacted pages so teams see what changed and why.

What is Friday Cleanup in Moxie Docs?

Friday Cleanup is a weekly docs-only automation on Pro and Team plans. Moxie batches small documentation fixes—stale pages, gaps, and drift—into a single pull request your team can review with Friday coffee. Nothing auto-merges; you hold the merge button.

How do AI coding agents get codebase context from Moxie Docs?

Every Moxie Docs plan includes an MCP (Model Context Protocol) server. Compatible agents and editors query it for current documentation, conventions, verified commands, and open gaps instead of guessing from partial file reads, which cuts token waste and wrong API assumptions.

What is an MCP server for codebases?

An MCP server for codebases exposes repository documentation and conventions to AI agents through the Model Context Protocol. Moxie Docs publishes one at /api/mcp with OAuth and bearer-token access so agents pull live, cited context about how your project actually works.

Does Moxie Docs work with private GitHub repositories?

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

How much does automated codebase documentation cost?

Moxie Docs offers Starter, Pro, and Team plans with a 14-day free trial on each. Starter fits solo builders, Pro adds Friday Cleanup and more seats, and Team adds priority indexing and unlimited seats. Annual billing is available with about two months free versus monthly.

What programming languages does Moxie Docs support?

Documentation and search work with any GitHub repository. Moxie recognizes all major languages including TypeScript, JavaScript, Python, Go, Rust, Ruby, Java, PHP, SQL, Svelte, and Vue, with deepest structured convention analysis for TypeScript/JavaScript, Python, Go, Rust, and Ruby.

How does Moxie Docs help onboard new engineers?

Moxie generates searchable architecture overviews, module walkthroughs, and convention guides cited to source files, then keeps them current on every merge. New engineers search one workspace instead of spelunking the repo, and AI agents they use inherit the same grounded context over MCP.

Can Moxie Docs generate architecture documentation from source code?

Yes. Moxie indexes your repository, builds an outline of modules and dependencies, and generates architecture pages, references, and convention summaries with citations back to the files they came from. Pages regenerate incrementally when the underlying code changes.

What is a hosted developer knowledgebase?

A hosted developer knowledgebase is a searchable documentation site grounded in your codebase. Moxie Docs publishes one on moxiedocs.app subdomains or custom domains with human review before anything goes public, hybrid search, and agent-ready pages citable through the Moxie MCP server.

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.