MCPcopy Index your code
hub / github.com/davialabs/davia

github.com/davialabs/davia @main

Chat with this repo
repository ↗ · DeepWiki ↗ · + Follow
982 symbols 2,518 edges 314 files 13 documented · 1%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

Davia Banner


Website   Docs   Package                     Discord   Cloud

What is Davia?

Davia is an open-source tool designed for AI coding agents to generate interactive internal documentation for your codebase. When your AI coding agent uses Davia, it writes documentation files locally with interactive visualizations and editable whiteboards that you can edit in a Notion-like platform or locally in your IDE.

Excalidraw Example


Quick Start

📚 For detailed documentation, visit docs.davia.ai

1. Install Davia CLI

npm i -g davia

2. Initialize Davia

Initialize Davia with your coding agent:

davia init --agent=[name of your coding agent]

Replace [name of your coding agent] with the name of your coding agent (e.g., cursor, github-copilot, windsurf, claude-code, augment).

3. Generate Documentation

Ask your AI coding agent to write the documentation for your project. Your agent will use Davia's tools to generate interactive documentation with visualizations and editable whiteboards.

4. View Your Documentation

Once your agent has generated the documentation, open the Davia workspace:

davia open

If the page doesn't load immediately, refresh the page in your browser.

5. Collaborate with Your Team

Sync your local documentation to a remote workspace where you can collaborate with your team in real-time:

davia push

This command will:

  • Ask you to log in if you haven't already (opens browser for authentication)
  • Create a new workspace for your project
  • Upload your documentation to the cloud
  • Open your workspace in the browser

📝 Note: Currently, updating a workspace you've already pushed isn't supported yet, but we'll be adding this feature very soon!

This is the view you'll have after sending your docs to the workspace:

Design Agent Example


Contributing

Contributions are welcome! We'd love your help to make Davia better:

  • Report bugs or request features — Open an issue to let us know what's not working or what you'd like to see
  • Improve the codebase — Submit pull requests with bug fixes, new features, or optimizations
  • Share feedback — Share your feedback on Discord and help shape Davia's future

Example

https://github.com/user-attachments/assets/dc2121c3-811d-47da-8762-0d5afd5c845d

Another example with flows:

https://github.com/user-attachments/assets/6eecb62f-3c13-434a-9aa0-a8dd3840bf49


License

This project is licensed under the MIT License - see the LICENSE file for details.


<a href="https://github.com/davialabs/davia/stargazers" alt="GitHub stars">
    <img src="https://img.shields.io/github/stars/davialabs/davia?style=social" /></a>
<a href="https://github.com/davialabs/davia/blob/main/LICENSE" alt="License">
    <img src="https://img.shields.io/github/license/davialabs/davia?style=flat&cacheSeconds=0" /></a>
<a href="https://github.com/davialabs/davia/issues" alt="GitHub Issues">
    <img src="https://img.shields.io/github/issues/davialabs/davia" /></a>
<a href="https://www.npmjs.com/package/davia" alt="npm">
    <img src="https://img.shields.io/npm/v/davia" /></a>
<a href="https://x.com/DaviaLabs" alt="X follow DaviaLabs">
    <img src="https://img.shields.io/twitter/follow/DaviaLabs?style=social" /></a>
<a href="https://discord.gg/A79mEzP8me" alt="Discord">
    <img src="https://dcbadge.limes.pink/api/server/A79mEzP8me?style=flat" /></a>
<a href="https://www.reddit.com/r/davia_ai/" alt="Reddit">
    <img src="https://img.shields.io/reddit/subreddit-subscribers/davia_ai?style=social&label=r/davia_ai" /></a>
<a href="https://docs.davia.ai/" alt="Documentation">
    <img src="https://img.shields.io/badge/docs-davia.ai-blue?style=flat" /></a>

Extension points exported contracts — how you extend this code

ContentBlockWithCacheControl (Interface)
* Type for content blocks with optional cache control
packages/agent/src/agent/helpers/messages-caching-handler.ts
DeviceCodeRequest (Interface)
(no doc)
apps/cli/src/sync.ts
NotFoundUIProps (Interface)
(no doc)
apps/web/src/components/error-not-found-ui.tsx
DeviceCodeResponse (Interface)
(no doc)
apps/cli/src/sync.ts
UiState (Interface)
(no doc)
apps/web/src/tiptap/ui-state-extension.ts
TokenRequest (Interface)
(no doc)
apps/cli/src/sync.ts
Commands (Interface)
(no doc)
apps/web/src/tiptap/ui-state-extension.ts
TokenResponse (Interface)
(no doc)
apps/cli/src/sync.ts

Core symbols most depended-on inside this repo

cn
called by 261
apps/web/public/shadcn/lib/utils.ts
cn
called by 261
apps/web/src/lib/utils.ts
useTiptapEditor
called by 21
apps/web/src/tiptap/hooks/use-tiptap-editor.ts
cn
called by 20
apps/web/src/tiptap/utils.ts
updateData
called by 14
apps/web/src/tiptap/hooks/use-data.ts
isNodeInSchema
called by 11
apps/web/src/tiptap/utils.ts
usePageRegistryStore
called by 9
apps/web/src/providers/page-registry/page-registry-store-provider.tsx
readProjects
called by 9
apps/web/src/lib/projects.ts

Shape

Function 926
Interface 56

Languages

TypeScript100%

Modules by API surface

apps/web/src/components/ui/sidebar.tsx25 symbols
apps/web/public/shadcn/components/ui/sidebar.tsx25 symbols
apps/cli/src/sync.ts19 symbols
apps/web/src/components/ui/menubar.tsx16 symbols
apps/web/public/shadcn/components/ui/menubar.tsx16 symbols
apps/web/src/tiptap/utils.ts15 symbols
apps/web/src/components/ui/dropdown-menu.tsx15 symbols
apps/web/src/components/ui/context-menu.tsx15 symbols
apps/web/public/shadcn/components/ui/dropdown-menu.tsx15 symbols
apps/web/public/shadcn/components/ui/context-menu.tsx15 symbols
apps/web/src/tiptap/ui/image-download-button/use-image-download.ts11 symbols
apps/web/src/components/ui/alert-dialog.tsx11 symbols

For agents

$ claude mcp add davia \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact