YodaMan

YodaMan is your code's memory palace. Private. Extensible. Graph-powered. It connects your projects, semantic search, agent tasks, approvals, plugins, desktop controls, VS Code, and mobile companion flows around one private local runtime.

Why YodaMan

• Keep code private: Designed around local project indexing and local model workflows through Context Expert and optional Ollama. No code leaves your machine.
• Understand the whole workspace: Search and ask across indexed repositories instead of juggling isolated editor tabs.
• See relationships, not fragments: Graphify builds mandatory knowledge graphs that connect code, docs, diagrams, and architectural concepts.
• Delegate carefully: Run agent tasks with streamed progress, persisted task history, cancellation, audit logs, and approval gates for file changes.
• Work where you already are: Web UI, desktop app, CLI, VS Code extension, and mobile companion all talk to the same runtime.
• Extend the assistant: Add JavaScript plugins for custom tools. Three pre-installed plugins (CodeTrooper, Droid-Sweep, Grand Inquisitor) plus community plugins like Lightsaber.
• Choose query intent: Switch between Code and Docs modes for more relevant answers.
• Recover gracefully: All clients show clear recovery guidance when the local service is unavailable.

Version 0.3.2 — What's New

• Pre-installed plugins: CodeTrooper (line counter), Droid-Sweep (unused file finder), Grand Inquisitor (dependency scanner), Lightsaber (Git hotspot analysis)
• Plugin enable/disable: Toggle any plugin on/off from Settings → Developer Settings without restarting
• Centralized settings: All environment-level settings managed through the Settings API and UI
• Legacy plugin support: Holocron VR and other community plugins using the onLoad lifecycle now work automatically
• Zip plugin upload: Upload plugins as .zip files — extracts and validates automatically
• Chat improvements: Code/Docs mode toggle, animated processing indicators, 10-second fallback for slow connections, Clear conversation button, 50-message cap
• Scrolling fixes: Vertical scrollbar in chat works properly

Core Pillars

Local-first intelligence

Project context stays on your machine. Watched directories in config.json are indexed locally and reused by chat, search, agent tasks, and external clients.

Human-controlled automation

The agent reasons through multi-step coding work, but write proposals require human approval. Events stream: task_started, tool activity, approvals, cancellation, final answers, errors.

One ecosystem runtime

The Express runtime is the shared contract for the React UI, Electron desktop shell, VS Code extension, mobile app, and CLI. Each client can ask, search, reindex, inspect tasks, and participate in approvals.

Extensible tools

Built-in tools cover file reads, controlled writes, exact patching, command execution, search, and file listing. Plugin tools in plugins/ extend functionality with declared permissions.

Sub-Projects

| Project | Location | Description | |---------|----------|-------------| | YodaMan Core | core/ | Main Express runtime, React UI, agent engine, plugins | | Lightsaber | lightsaber/ | Git health map plugin — code hotspot analysis | | Holocron VR | Holocron VR/ | 3D VR codebase explorer (community plugin) |

Prerequisites

• Node.js 18+
• Python 3.10+
• Context Expert CLI: npm install -g @contextexpert/cli
• Graphify: pip install graphifyy
• Ollama (for local model execution)

Quick Start

git clone https://github.com/Yoda-Man/yodaman.git
cd yodaman
npm install
sh setup.sh
npm start

The runtime listens on http://localhost:3090. For the desktop app:

npm run desktop

Key Technologies

| Layer | Technology | |-------|-----------| | Runtime | Node.js/Express | | Frontend | React 18 + Vite + Tailwind CSS | | AI/LLM | Ollama (qwen3.5:9b) | | Embeddings | HuggingFace (BAAI/bge-large-en-v1.5) | | Knowledge Graph | Graphify | | Code Indexing | Context Expert (ctx) | | Desktop | Electron | | Mobile | React Native (companion) | | VS Code | Extension API | | Database | SQLite + JSON/JSONL fallback | | Git | simple-git |

Project Structure

yodaman/
├── backend/                    # Express runtime
│   ├── core/                   # Agent engine, queue service
│   ├── infrastructure/         # ToolBox, Graphify, ContextEngine, Logger
│   ├── interfaces/             # REST controller (all API routes)
│   ├── services/               # Git, search, chat, file upload
│   └── utils/                  # Doc preprocessing, query classification
├── bin/                        # CLI entrypoint (yodaman)
├── dist/                       # Built frontend
├── electron/                   # Desktop app shell
├── extensions/vscode-yodaman/  # VS Code extension
├── frontend/                   # Shared frontend utilities
├── plugins/                    # Installed plugins (CodeTrooper, Droid-Sweep, etc.)
├── scripts/                    # Build and release scripts
├── shared/                     # Shared protocol/types for external clients
├── src/                        # React UI source
├── tests/                      # Jest test suites
├── website/                    # Public website + downloads
├── server.js                   # Express entry point
├── start.js                    # CLI launcher
└── package.json

Configuration

Copy config.example.json to config.json and add your workspace paths:

{
  "watchedDirectories": ["/path/to/your/project"]
}

All developer settings (plugin uploads, unrestricted plugins, agent commands) are managed through Settings → Developer Settings in the UI.

Clients

• Web UI: React control center at http://localhost:3090
• Desktop app: Electron shell with managed runtime
• VS Code extension: Editor-native access from the command palette
• Mobile companion: React Native app for task monitoring and approvals

License

MIT