[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-75806":3},{"id":4,"name":5,"fullName":6,"owner":5,"repo":5,"description":7,"homepage":8,"htmlUrl":9,"language":10,"languages":8,"totalLinesOfCode":8,"stars":11,"forks":12,"watchers":13,"openIssues":14,"contributorsCount":8,"subscribersCount":15,"size":15,"stars1d":16,"stars7d":17,"stars30d":18,"stars90d":15,"forks30d":15,"starsTrendScore":19,"compositeScore":20,"rankGlobal":8,"rankLanguage":8,"license":8,"archived":21,"fork":21,"defaultBranch":22,"hasWiki":21,"hasPages":21,"topics":23,"createdAt":8,"pushedAt":8,"updatedAt":40,"readmeContent":41,"aiSummary":42,"trendingCount":15,"starSnapshotCount":15,"syncStatus":43,"lastSyncTime":44,"discoverSource":45},75806,"CodeBoarding","CodeBoarding\u002FCodeBoarding","Interactive architecture diagrams for codebases",null,"https:\u002F\u002Fgithub.com\u002FCodeBoarding\u002FCodeBoarding","Python",2139,178,12,8,0,47,135,555,141,28.76,false,"main",[24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39],"agents","aiagentic","explainability","llms","static-analysis","codedocs","codedocumentator","python3","typescript","language-server-client","language-server-protocol","lsp","lsp-client","hacktoberfest","golang","typescipt","2026-06-12 02:03:36","# CodeBoarding\n\nSee what your AI is building before it breaks.\n\nCodeBoarding gives developers and coding agents a visual map of a codebase. It combines static analysis with LLM reasoning to generate architecture diagrams, component-level documentation, and navigable outputs you can use in your IDE, CI, and docs.\n\n[Website](https:\u002F\u002Fcodeboarding.org) · [Open VSX extension](https:\u002F\u002Fopen-vsx.org\u002Fextension\u002FCodeBoarding\u002Fcodeboarding) · [Explore examples](https:\u002F\u002Fcodeboarding.org\u002Fdiagrams) · [VS Code extension](https:\u002F\u002Fmarketplace.visualstudio.com\u002Fitems?itemName=Codeboarding.codeboarding) · [GitHub Action](https:\u002F\u002Fgithub.com\u002Fmarketplace\u002Factions\u002Fcodeboarding-diagram-first-documentation) ·[Discord](https:\u002F\u002Fdiscord.gg\u002FT5zHTJYFuy)\n\n[![CodeBoarding demo](https:\u002F\u002Fgist.githubusercontent.com\u002Fivanmilevtues\u002F1c4f921066613516cfd7b938014a6877\u002Fraw\u002F611aec7711556807860ff2e1679a5dc4c0c23fed\u002FCodeBoarding_extension_demo.gif)](https:\u002F\u002Fopen-vsx.org\u002Fextension\u002FCodeBoarding\u002Fcodeboarding)\n\nInstall the extension from Open VSX.\n\n[![JavaScript](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FJavaScript-222222?style=flat-square&logo=javascript&logoColor=F7DF1E)](https:\u002F\u002Fdeveloper.mozilla.org\u002Fen-US\u002Fdocs\u002FWeb\u002FJavaScript)\n[![TypeScript](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FTypeScript-3178C6?style=flat-square&logo=typescript&logoColor=white)](https:\u002F\u002Fwww.typescriptlang.org\u002F)\n[![Java](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FJava-E76F00?style=flat-square&logo=openjdk&logoColor=white)](https:\u002F\u002Fwww.java.com\u002F)\n[![Python](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FPython-3776AB?style=flat-square&logo=python&logoColor=white)](https:\u002F\u002Fwww.python.org\u002F)\n[![Go](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FGo-00ADD8?style=flat-square&logo=go&logoColor=white)](https:\u002F\u002Fgo.dev\u002F)\n[![PHP](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FPHP-777BB4?style=flat-square&logo=php&logoColor=white)](https:\u002F\u002Fwww.php.net\u002F)\n[![Rust](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FRust-000000?style=flat-square&logo=rust&logoColor=white)](https:\u002F\u002Fwww.rust-lang.org\u002F)\n[![C#](https:\u002F\u002Fcustom-icon-badges.demolab.com\u002Fbadge\u002FC%23-512BD4.svg?style=flat-square&logo=cshrp&logoColor=white)](https:\u002F\u002Flearn.microsoft.com\u002Fen-us\u002Fdotnet\u002Fcsharp\u002F)\n\n## Few use cases:\n\n- Keep architecture visible while agents code.\n- Review AI-generated changes with system context before they turn into hidden debt.\n- Understand large repositories faster with layered diagrams and component breakdowns.\n- Share the same visual model across local workflows, IDEs, pull requests, and docs.\n\n## What CodeBoarding generates\n\n- High-level system architecture diagrams.\n- Deeper component diagrams for important subsystems.\n- Markdown documentation in `.codeboarding\u002F`.\n- Mermaid output that is easy to embed in docs and PRs.\n- Incremental updates when only part of the codebase changes.\n\n## How it works\n\n```mermaid\ngraph LR\n    Application_Orchestrator_Repository_Manager[\"Application Orchestrator & Repository Manager\"]\n    LLM_Agent_Core[\"LLM Agent Core\"]\n    Static_Code_Analyzer[\"Static Code Analyzer\"]\n    Agent_Tooling_Interface[\"Agent Tooling Interface\"]\n    Incremental_Analysis_Engine[\"Incremental Analysis Engine\"]\n    Documentation_Diagram_Generator[\"Documentation & Diagram Generator\"]\n    Application_Orchestrator_Repository_Manager -- \"Orchestrator initiates analysis workflow, leveraging incremental updates based on detected code changes.\" --> Incremental_Analysis_Engine\n    Application_Orchestrator_Repository_Manager -- \"Orchestrator passes project context and triggers the main analysis workflow for the LLM Agent.\" --> LLM_Agent_Core\n    Incremental_Analysis_Engine -- \"Incremental engine requests static analysis for specific code segments (new or changed).\" --> Static_Code_Analyzer\n    Static_Code_Analyzer -- \"Static analyzer provides analysis results to the incremental engine for caching.\" --> Incremental_Analysis_Engine\n    LLM_Agent_Core -- \"LLM Agent invokes specialized tools to interact with the codebase and analysis data.\" --> Agent_Tooling_Interface\n    Agent_Tooling_Interface -- \"Agent tools query the static analysis engine for detailed code insights.\" --> Static_Code_Analyzer\n    Static_Code_Analyzer -- \"Static analysis engine provides requested data to the agent tools.\" --> Agent_Tooling_Interface\n    LLM_Agent_Core -- \"LLM Agent delivers structured analysis insights for documentation and diagram generation.\" --> Documentation_Diagram_Generator\n    click Application_Orchestrator_Repository_Manager href \"https:\u002F\u002Fgithub.com\u002FCodeBoarding\u002FCodeBoarding\u002Fblob\u002Fmain\u002F.codeboarding\u002FApplication_Orchestrator_Repository_Manager.md\" \"Details\"\n    click LLM_Agent_Core href \"https:\u002F\u002Fgithub.com\u002FCodeBoarding\u002FCodeBoarding\u002Fblob\u002Fmain\u002F.codeboarding\u002FLLM_Agent_Core.md\" \"Details\"\n    click Static_Code_Analyzer href \"https:\u002F\u002Fgithub.com\u002FCodeBoarding\u002FCodeBoarding\u002Fblob\u002Fmain\u002F.codeboarding\u002FStatic_Code_Analyzer.md\" \"Details\"\n    click Agent_Tooling_Interface href \"https:\u002F\u002Fgithub.com\u002FCodeBoarding\u002FCodeBoarding\u002Fblob\u002Fmain\u002F.codeboarding\u002FAgent_Tooling_Interface.md\" \"Details\"\n    click Incremental_Analysis_Engine href \"https:\u002F\u002Fgithub.com\u002FCodeBoarding\u002FCodeBoarding\u002Fblob\u002Fmain\u002F.codeboarding\u002FIncremental_Analysis_Engine.md\" \"Details\"\n    click Documentation_Diagram_Generator href \"https:\u002F\u002Fgithub.com\u002FCodeBoarding\u002FCodeBoarding\u002Fblob\u002Fmain\u002F.codeboarding\u002FDocumentation_Diagram_Generator.md\" \"Details\"\n```\n\nFor a deeper architecture walkthrough, see [`.codeboarding\u002Foverview.md`](.codeboarding\u002Foverview.md).\n\n## Quick start\n\n### Run from source\n\n```bash\nuv sync --frozen\nsource .venv\u002Fbin\u002Factivate  # On Windows: .venv\\Scripts\\activate\npython install.py\npython main.py full --local \u002Fpath\u002Fto\u002Frepo\n```\n\n### Use the packaged CLI\n\nRequires **Python 3.12 or 3.13**. The recommended install method is [pipx](https:\u002F\u002Fpipx.pypa.io), which keeps the CLI in its own isolated environment:\n\n```bash\npipx install codeboarding --python python3.12\ncodeboarding-setup\ncodeboarding full --local \u002Fpath\u002Fto\u002Frepo\n```\n\nOr, if you prefer pip, install into a virtual environment (not the global Python):\n\n```bash\npip install codeboarding\ncodeboarding-setup\ncodeboarding full --local \u002Fpath\u002Fto\u002Frepo\n```\n\nOutput is written to `\u002Fpath\u002Fto\u002Frepo\u002F.codeboarding\u002F`.\n\n`python install.py` and `codeboarding-setup` download language server binaries to `~\u002F.codeboarding\u002Fservers\u002F`, shared across projects. Node.js (and its bundled `npm`) is required for the Python, TypeScript, JavaScript, and PHP language servers; if neither `node` nor `CODEBOARDING_NODE_PATH` is set, setup downloads a pinned Node.js runtime into `~\u002F.codeboarding\u002Fservers\u002Fnodeenv\u002F` automatically.\n\n## Configuration\n\nOn first run, CodeBoarding creates `~\u002F.codeboarding\u002Fconfig.toml`. Set one provider there or use environment variables.\n\n```toml\n[provider]\n# openai_api_key            = \"sk-...\"\n# anthropic_api_key         = \"sk-ant-...\"\n# google_api_key            = \"AIza...\"\n# vercel_api_key            = \"vck_...\"\n# aws_bearer_token_bedrock  = \"...\"\n# ollama_base_url           = \"http:\u002F\u002Flocalhost:11434\"\n# openrouter_api_key        = \"sk-...\"\n\n[llm]\n# agent_model   = \"gemini-3-flash\"\n# parsing_model = \"gemini-3-flash\"\n```\n\nShell environment variables such as `OPENAI_API_KEY`, `ANTHROPIC_API_KEY`, `GOOGLE_API_KEY`, and `OLLAMA_BASE_URL` take precedence over the config file. For private repositories, set `GITHUB_TOKEN` in your environment.\n\n## Common commands\n\n```bash\n# Analyze a local repository\npython main.py full --local .\u002Fmy-project\n\n# Increase diagram depth\npython main.py full --local .\u002Fmy-project --depth-level 2\n\n# Re-analyze only changed parts when possible\npython main.py incremental --local .\u002Fmy-project\n\n# Update a single component by ID\npython main.py partial --local .\u002Fmy-project --component-id \"1.2\"\n\n# Analyze a remote GitHub repository\npython main.py full https:\u002F\u002Fgithub.com\u002Fpytorch\u002Fpytorch\n```\n\n## Where to use it\n\n- [CLI](https:\u002F\u002Fgithub.com\u002FCodeBoarding\u002FCodeBoarding) for local analysis, automation, and CI workflows.\n- [VS Code extension](https:\u002F\u002Fmarketplace.visualstudio.com\u002Fitems?itemName=Codeboarding.codeboarding) for in-editor visual architecture.\n- [GitHub Action](https:\u002F\u002Fgithub.com\u002Fmarketplace\u002Factions\u002Fcodeboarding-diagram-first-documentation) to keep diagrams updated in CI.\n\n## Supported stack\n\n- Languages: Python, TypeScript, JavaScript, Java, Go, PHP, Rust, C#.\n- LLM providers: OpenAI, Anthropic, Google, Vercel AI Gateway, AWS Bedrock, Ollama, OpenRouter, and more.\n\n## Examples\n\n- Visualized 800+ open-source repositories.\n- Browse generated examples in [GeneratedOnBoardings](https:\u002F\u002Fgithub.com\u002FCodeBoarding\u002FGeneratedOnBoardings).\n- Try the hosted explorer at [codeboarding.org\u002Fdiagrams](https:\u002F\u002Fcodeboarding.org\u002Fdiagrams).\n\n## Contributing\n\nIf you want to improve CodeBoarding, open an [issue](https:\u002F\u002Fgithub.com\u002FCodeBoarding\u002FCodeBoarding\u002Fissues) or send a pull request. We welcome improvements to analysis quality, output generators, integrations, and developer experience.\n\n## Vision\n\nCodeBoarding is building an open standard for code understanding: a visual, accurate, high-level representation of a codebase that both humans and agents can use.\n","CodeBoarding 是一个为代码库生成交互式架构图的工具。它通过结合静态分析与大语言模型推理，能够生成系统级别的架构图、组件级文档以及可在IDE、CI和文档中使用的可导航输出。项目支持多种编程语言如JavaScript、TypeScript、Java、Python等，并提供了VS Code扩展、GitHub Action等多种集成方式。适用于需要保持代码结构清晰可见的开发场景，特别是在使用AI辅助编码时帮助审查变更、理解大型仓库结构或在团队内部共享一致的视觉模型。",2,"2026-06-11 03:53:23","trending"]