Arkhe - AI Architect

Visualize. Collaborate. Evolve.

An AI-powered VS Code extension that turns your ideas into structured architecture diagrams and keeps them in sync with your codebase.

Arkhe bridges the gap between conceptual design and physical implementation. It lives directly inside VS Code and uses advanced LLMs to help you visualize abstract ideas into concrete folder structures, render them as interactive Mermaid diagrams, and monitor the "drift" between your planned architecture and the actual file system.

Whether you are starting a new project or refactoring an existing one, Arkhe ensures your documentation and code never fall out of step.

• AI-Powered Design: Describe your stack (e.g., "Next.js with Prisma and tRPC") and get a best-practice folder structure generated instantly.
• Instant Visualization: See your architecture as an interactive Mermaid.js graph before you write a single line of code.
• Drift Detection: Arkhe compares your architectural plan (.repoplan.json) against your actual file system to highlight missing or untracked files.
• Guided Sync: A step-by-step wizard to resolve differences—update your plan or scaffold the missing files.
• Secure: Your keys are stored safely using VS Code's native SecretStorage.

We use modern web technologies to build a seamless extension experience:

• Extension Host: TypeScript
• UI: React, Vite, Tailwind CSS (Webview)
• AI Orchestration: LangChain.js
• Diagramming: Mermaid.js
• State Management: Zustand / Context API

Want to contribute or build it locally? Follow these steps:

• Node.js (v18+)
• npm or pnpm
• VS Code

1. Clone the repository

   git clone https://github.com/ai-marvin123/arkhe.git
   cd arkhe

2. Install dependencies

   npm install
   # Install webview dependencies
   cd webview-ui && npm install && cd ..

3. Run in Debug Mode

   • Open the project in VS Code.
   • Press F5 to launch the Extension Development Host.
   • In the new window, run the command Arkhe: Open Chat.

To create a distributable .vsix file:

npm run vscode:prepublish
npx vsce package

We love contributions! Whether it's a bug fix, new feature, or documentation improvement.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

Distributed under the MIT License. See LICENSE for more information.