docuson 0.1.0b1

AI-powered documentation engine for vibe coders

Docuson

AI-Powered Documentation Engine for Vibe Coders

Docuson scans your codebase and generates complete, professional documentation in minutes — architecture diagrams, API references, security audits, database schemas, and more. One command. Works with code generated by Cursor, GitHub Copilot, Claude Code, and any AI coding tool.

Why Docuson

• 41% of all code is now AI-generated (GitHub, 2025) — but nobody documents it
• 2.7x more vulnerabilities in AI-generated code vs human-written (Veracode)
• 69% of developers lose 8+ hours weekly to poor documentation

Docuson is the documentation layer between you and your AI-generated code.

Installation

pip install docuson

Quick Start

# Initialize in your project
docuson init

# Scan your codebase (free, no API calls)
docuson scan

# Generate full documentation
docuson generate

# Preview the HTML docs locally
docuson serve

What Docuson Generates

9 Specialized Analysis Passes

Pass	What It Covers
Architecture	System overview, tech stack, design patterns, project structure
Data Layer	Database schema, ER diagrams, ORM analysis, migrations
API Layer	All endpoints, middleware, request/response schemas
Business Logic	Features, user flows, business rules, state machines
Frontend	Component hierarchy, state management, routing
Security	Auth system, vulnerabilities, secrets, OWASP flags
Infrastructure	Docker, CI/CD, deployment, monitoring
Cross-cutting	Error handling, logging, caching, config
Synthesis	Executive summary, health score, setup guide, glossary

Dual-View Output

• Business View — Plain English for founders, PMs, investors
• Developer View — Technical deep-dive with code references

Output Formats

• Markdown (default)
• HTML site with search, dark mode, sidebar navigation
• PDF with cover page, TOC, diagrams

Supported Languages (30+)

TypeScript, JavaScript, Python, Java, Kotlin, Go, Rust, Ruby, PHP, C#, Swift, Dart, C/C++, Scala, Elixir, and more — powered by Tree-sitter AST parsing.

Supported Frameworks (20+)

Next.js, React, FastAPI, Django, Flask, Express, Spring Boot, Rails, Laravel, Flutter, Gin, Actix-web, ASP.NET, Ktor, Nuxt, SvelteKit, Remix, Angular, Vue, and more.

All CLI Commands

docuson init          # Initialize in a project
docuson scan          # Scan codebase (free, no API)
docuson generate      # Generate documentation
docuson serve         # Preview HTML docs locally
docuson status        # Show documentation status
docuson diff          # Show changes since last generation
docuson usage         # Show token usage and budget
docuson github <url>  # Document a GitHub repo
docuson assist        # Live Assistant (real-time code notes)
docuson mcp-serve     # Start MCP server for AI tool integration
docuson config show   # Show configuration

VS Code Extension

Install the Docuson extension for VS Code / Cursor:

• Generate docs from the command palette
• Status bar showing documentation state
• Live Assistant with inline diagnostics
• Sidebar with project status and quick actions

MCP Server (AI Tool Integration)

Docuson exposes project knowledge via MCP so Claude Code, Copilot, and other AI tools can query your docs:

{
  "mcpServers": {
    "docuson": {
      "command": "docuson",
      "args": ["mcp-serve", "--path", "/your/project"]
    }
  }
}

Configuration

# Set your Anthropic API key
export DOCUSON_API_KEY=sk-ant-...

# Or configure interactively
docuson config set-key

Configuration lives in .docuson/config.yaml. See docuson config show for current settings.

Requirements

• Python 3.10+
• Anthropic API key (for generate command — scan is free)

License

MIT