Codebase OS is not a chatbot. It is a principal-grade autonomous system that treats your entire repository as a living relationship graph. It doesn't just "suggest" code—it plans, executes, validates, and self-heals complex engineering tasks with surgical precision.
Codebase OS operates on a hardened 5-Layer "Spaceship" Infrastructure:
- Visual Foundation: A high-fidelity Dashboard with glassmorphism, GSAP-powered reasoning feeds, and real-time diff visualizations.
- Standardized Orchestration: A config-first routing layer that synchronizes OpenAI, Anthropic, Gemini, and Local (Ollama) providers with fail-safe reliability.
- Intelligence Logic: Mathematical "Leaky Bucket" rate limiting and autonomous planning engines that decompose high-level intents into executable atoms.
- Graph Persistence: A persistent, incrementally maintained dependency graph that understands how a change in your database schema impacts your frontend components.
- Parallel Execution Core: Parallelized Vector RAG and sandboxed shell operations that reduce repository scan times from minutes to milliseconds.
Important
Autonomy Over Automation: Codebase OS is designed for developers who demand principal-grade results.
- ⚡ Parallel Vector RAG: Leveraging batch embedding and concurrent processing to map 100+ file repositories in under 2 seconds.
- 🛡️ Config-First Routing: Universal model identifiers and provider-aware failover logic ensure 100% request success.
- 🔍 Root Cause Diagnostics: Deep temporal investigation that maps failures back to specific commits and structural regressions.
- 📺 Sovereign Dashboard: A premium, state-of-the-art visual interface for monitoring active reasoning and architectural integrity.
# 1. Clone the Sovereign Core
git clone https://github.com/dharan1007/codebase--os.git
cd codebase-os
# 2. Build and Global Link
npm install
npm run build
npm link
# 3. Initialize your Workspace
cos init # Interactive project preset selection
cos scan # Map the relationship graph
cos config # Live model discovery (OpenRouter/Anthropic/Gemini)| Command | Action |
|---|---|
cos agent |
Launch the autonomous agent for high-impact feature builds. |
cos fix |
Self-healing diagnostics for structural or logic regressions. |
cos scan |
Incrementally refresh the codebase relationship graph. |
cos serve |
Boot the Sovereign Dashboard for real-time visual monitoring. |
cos config |
Interactively manage providers, budgets, and model tiers. |
Codebase OS is built with Sovereign Engineering principles:
- Zero-Dependency Design: Logic is separated from utility bloat.
- Deterministic State: Every agent action is logged and reversible.
- Premium Aesthetics: Curated color palettes and accessible typography for long-session comfort.
This is the Sovereign Edition—a gift to the engineering community for personal and research productivity.
Dharantej Reddy Poduvu
dharan.poduvu@gmail.com | GitHub
