docs: complete README overhaul and fix internal links

README.md:
- Rename to OpenCodeIntel (consistent branding)
- Add badges (CI, license, release)
- Add Quick Links navigation
- Remove emoji headers
- Cleaner structure: features → quickstart → docs
- Leave placeholder for logo and demo screenshot
- Concise, no fluff

CONTRIBUTING.md:
- Update repo name to opencodeintel
- Remove emoji

docs/:
- Fix cross-references to renamed files
- Convert to proper markdown links

Part of #180

Author: DevanshuNEU

CONTRIBUTING.md

@@ -1,13 +1,13 @@
-# Contributing to CodeIntel
+# Contributing to OpenCodeIntel
 
-First off, thanks for considering contributing! CodeIntel is better because of people like you.
+Thanks for considering contributing! OpenCodeIntel is better because of people like you.
 
 ## Quick Start
 
 ```bash
 # Fork the repo, then clone
-git clone https://github.com/YOUR_USERNAME/codeintel-mcp
-cd codeintel-mcp
+git clone https://github.com/YOUR_USERNAME/opencodeintel
+cd opencodeintel
 
 # Set up backend
 cd backend
@@ -138,4 +138,4 @@ Be respectful, constructive, and collaborative. We're all here to build somethin
 
 ---
 
-**Thanks for contributing! 🚀**
+**Thanks for contributing!**

README.md

@@ -1,154 +1,99 @@
-# CodeIntel MCP
+<p align="center">
+  <!-- Logo placeholder - replace with actual logo -->
+  <h1 align="center">OpenCodeIntel</h1>
+</p>
+
+<p align="center">
+  <strong>AI-powered semantic code search for your repositories</strong>
+</p>
+
+<p align="center">
+  <a href="https://github.com/OpenCodeIntel/opencodeintel/actions/workflows/ci.yml">
+    <img src="https://github.com/OpenCodeIntel/opencodeintel/actions/workflows/ci.yml/badge.svg" alt="CI Status" />
+  </a>
+  <a href="https://github.com/OpenCodeIntel/opencodeintel/blob/main/LICENSE">
+    <img src="https://img.shields.io/github/license/OpenCodeIntel/opencodeintel" alt="License" />
+  </a>
+  <a href="https://github.com/OpenCodeIntel/opencodeintel/releases">
+    <img src="https://img.shields.io/github/v/release/OpenCodeIntel/opencodeintel?include_prereleases" alt="Release" />
+  </a>
+</p>
+
+<p align="center">
+  <a href="#quick-start">Quick Start</a> •
+  <a href="./docs/deployment.md">Deployment</a> •
+  <a href="./docs/mcp-setup.md">MCP Integration</a> •
+  <a href="./CONTRIBUTING.md">Contributing</a>
+</p>
 
-**MCP server for AI-powered codebase intelligence.** Semantic search, dependency analysis, and impact prediction for your repositories.
-
-## The Problem
-
-AI coding assistants are powerful, but they're flying blind in large codebases:
-- Can't semantically search across thousands of files
-- Don't understand dependency relationships
-- Can't predict what breaks when you change a file
-- Have no context on team coding patterns
-
-## The Solution
-
-CodeIntel is an MCP (Model Context Protocol) server that gives AI agents deep codebase understanding:
-
-```typescript
-// Ask Claude (via MCP):
-"Find authentication middleware in this repo"
-
-// CodeIntel semantically searches 10,000+ functions
-// Returns exact implementations, not keyword matches
-```
-
-**Built for production. Not a demo.**
-
-## Key Features
-
-### 🔍 Semantic Code Search
-Search by meaning, not keywords. Find `"error handling logic"` even if functions are named `processFailure()`.
-
-### 📊 Dependency Analysis  
-Visualize your entire codebase architecture. See which files are critical, which are isolated, and how everything connects.
+---
 
-### ⚡ Impact Prediction
-Before changing a file, know exactly what breaks:
-```
-src/auth/middleware.py
-└─ 15 files affected (HIGH RISK)
-   ├─ src/api/routes.py
-   ├─ src/services/user.py
-   └─ ... + 12 more
-```
+<!-- Demo screenshot placeholder -->
+<!-- <p align="center">
+  <img src="docs/assets/demo.png" alt="OpenCodeIntel Dashboard" width="800" />
+</p> -->
 
-### 🎨 Code Style Analysis
-Understand team patterns: naming conventions (camelCase vs snake_case), async adoption %, type hint usage.
+## What is OpenCodeIntel?
 
-### 🚀 Performance That Scales
+OpenCodeIntel gives AI coding assistants deep understanding of your codebase. It's an MCP server that provides semantic code search, dependency analysis, and impact prediction.
 
-**Batch Processing:** 100x faster indexing
-- Before: 40+ min for 1,000 functions (individual API calls)
-- After: 22.9 sec (batch embedding requests)
+**Search by meaning, not keywords.** Find "error handling logic" even when functions are named `processFailure()`.
 
-**Incremental Indexing:** 700x faster re-indexing  
-- Full re-index: 51.4s
-- Incremental (git diff): 0.07s
-- Perfect for active development
+## Features
 
-**Supabase Caching:** 5x search speedup
-- Cold search: 800ms
-- Cached: 150ms
+- **Semantic Search** - Vector-based code search that understands intent
+- **Dependency Graph** - Visualize how your codebase connects
+- **Impact Analysis** - Know what breaks before you change a file
+- **Code Style Analysis** - Understand team patterns and conventions
+- **MCP Integration** - Works directly with Claude Desktop
 
 ## Quick Start
 
-### 🐳 Docker (Recommended)
-
-**Fastest way to get started:**
+### Using Docker (Recommended)
 
 ```bash
-# 1. Clone repo
 git clone https://github.com/OpenCodeIntel/opencodeintel.git
 cd opencodeintel
 
-# 2. Configure environment
 cp .env.example .env
-# Edit .env with your API keys
+# Add your API keys to .env
 
-# 3. Start everything
 docker compose up -d
-
-# Frontend: http://localhost:3000
-# Backend: http://localhost:8000
-# Docs: http://localhost:8000/docs
 ```
 
-**Full guide:** [`DOCKER_QUICKSTART.md`](./DOCKER_QUICKSTART.md)  
-**Troubleshooting:** [`DOCKER_TROUBLESHOOTING.md`](./DOCKER_TROUBLESHOOTING.md)
+- Frontend: http://localhost:3000
+- Backend: http://localhost:8000
+- API Docs: http://localhost:8000/docs
 
----
-
-### 📦 Manual Setup
+### Manual Setup
 
-### Prerequisites
-- Python 3.11+
-- Node.js 20+
-- OpenAI API key
-- Pinecone account
-- Supabase project
-
-### 1. Clone & Setup Backend
+**Requirements:** Python 3.11+, Node.js 20+
 
 ```bash
+# Backend
 cd backend
 python -m venv venv
-source venv/bin/activate  # Windows: venv\Scripts\activate
+source venv/bin/activate
 pip install -r requirements.txt
-
-# Configure .env
 cp .env.example .env
-# Add your API keys to .env
-```
-
-### 2. Run Backend
-
-```bash
 python main.py
-# Server runs on http://localhost:8000
-```
 
-### 3. Setup Frontend
-
-```bash
+# Frontend (new terminal)
 cd frontend
 npm install
 npm run dev
-# UI at http://localhost:5173
-```
-
-### 4. Add a Repository
-
-```bash
-# Via API
-curl -X POST http://localhost:8000/api/repos \
-  -H "Authorization: Bearer dev-secret-key" \
-  -H "Content-Type: application/json" \
-  -d '{"name": "zustand", "git_url": "https://github.com/pmndrs/zustand"}'
-
-# Or use the web UI
 ```
 
 ## MCP Integration
 
-CodeIntel works as an MCP server with Claude Desktop. **[📚 Full MCP Setup Guide](./docs/MCP_SETUP.md)**
+Connect OpenCodeIntel to Claude Desktop for AI-powered code assistance.
 
-**Quick Setup:**
+Add to your Claude Desktop config:
 
 ```json
-// Add to Claude Desktop config
 {
   "mcpServers": {
-    "codeintel": {
+    "opencodeintel": {
       "command": "python",
       "args": ["/path/to/opencodeintel/mcp-server/server.py"],
       "env": {
@@ -160,142 +105,41 @@ CodeIntel works as an MCP server with Claude Desktop. **[📚 Full MCP Setup Gui
 }
 ```
 
-**Available MCP Tools:**
-| Tool | Description |
-|------|-------------|
-| `search_code` | Semantic code search - finds code by meaning |
-| `list_repositories` | View all indexed repos |
-| `get_dependency_graph` | Visualize architecture and file connections |
-| `analyze_code_style` | Team conventions and patterns |
-| `analyze_impact` | Know what breaks before you change it |
-| `get_repository_insights` | High-level codebase overview |
-
-Now ask Claude: *"What's the authentication logic in the user service?"* and it searches your actual codebase.
+**Available tools:** `search_code`, `list_repositories`, `get_dependency_graph`, `analyze_code_style`, `analyze_impact`, `get_repository_insights`
 
-**[→ Complete setup guide with troubleshooting](./docs/MCP_SETUP.md)**
+See [MCP Setup Guide](./docs/mcp-setup.md) for detailed instructions.
 
 ## Architecture
 
 ```
-┌─────────────┐
-│   Frontend  │  React + TypeScript + Tailwind
-│  (Vite app) │  Dependency graphs, search UI
-└──────┬──────┘
-       │
-┌──────▼──────┐
-│   FastAPI   │  Python backend
-│   Backend   │  /api/search, /api/repos/{id}/dependencies
-└──────┬──────┘
-       │
-       ├─────► Pinecone (vector search)
-       ├─────► OpenAI (embeddings)
-       ├─────► Supabase (persistence)
-       └─────► Redis (caching)
-```
-
-**Tech Stack:**
-- **Backend:** FastAPI, tree-sitter (AST parsing), OpenAI embeddings
-- **Vector DB:** Pinecone for semantic search
-- **Database:** Supabase (PostgreSQL) for metadata + caching
-- **Cache:** Redis for 5x search speedup
-- **Frontend:** React, TypeScript, Tailwind CSS, shadcn/ui, ReactFlow
-
-## Performance Benchmarks
-
-Real numbers from indexing the Zustand repository (1,174 functions):
-
-| Metric | Value |
-|--------|-------|
-| Full indexing | 29.5s (39.7 functions/sec) |
-| Incremental re-index | 0.07s (700x faster) |
-| Batch embedding | 22.9s for 1,174 functions |
-| Search (cold) | 800ms |
-| Search (cached) | 150ms |
-
-## Use Cases
-
-**For AI Agents (via MCP):**
-- Semantic code search during pair programming
-- Understanding unfamiliar codebases
-- Finding implementation patterns
-- Impact analysis before refactoring
-
-**For Development Teams:**
-- Onboarding new engineers (visualize architecture)
-- Code review prep (see change blast radius)
-- Tech debt identification (find highly coupled files)
-- Pattern enforcement (analyze style consistency)
-
-## What Makes This Different
-
-**Most code search tools:** Keyword matching (grep, GitHub search)  
-**CodeIntel:** Understands *meaning* - finds `error handling` even if the function is called `processFailure()`
-
-**Most dependency tools:** Static analysis only  
-**CodeIntel:** Combines AST parsing + semantic understanding + impact prediction
-
-**Most demos:** In-memory, doesn't scale  
-**CodeIntel:** Production-grade with Supabase persistence, Redis caching, incremental indexing
-
-## Deployment
-
-### 🐳 Local Development (Docker)
-```bash
-# Start all services
-make dev
-
-# Or using docker compose
-docker compose -f docker-compose.dev.yml up -d
-
-# Services available at:
-# - Backend: http://localhost:8000
-# - Frontend: http://localhost:3000
-# - API Docs: http://localhost:8000/docs
-```
-
-### ☁️ Production Deployment
-
-**Backend + Redis → Railway**
-```bash
-# Automated deployment
-./scripts/deploy-railway.sh
-
-# Or manually:
-railway login
-railway init
-railway up
+Frontend (React + TypeScript)
+     ↓
+Backend (FastAPI + Python)
+     ↓
+┌────┴────┬────────────┐
+Pinecone  Supabase    Redis
+(vectors) (database)  (cache)
 ```
 
-**Frontend → Vercel**
-```bash
-# Automated deployment
-./scripts/deploy-vercel.sh
+**Stack:** FastAPI, React, TypeScript, Pinecone, Supabase, Redis, tree-sitter
 
-# Or manually:
-cd frontend
-vercel --prod
-```
+## Documentation
 
-**📚 Full deployment guide:** See [DEPLOYMENT.md](DEPLOYMENT.md) for complete instructions, environment variables, and troubleshooting.
+| Guide | Description |
+|-------|-------------|
+| [Docker Quickstart](./docs/docker-quickstart.md) | Get running in 5 minutes |
+| [Deployment](./docs/deployment.md) | Production deployment guide |
+| [MCP Setup](./docs/mcp-setup.md) | Claude Desktop integration |
+| [Docker Troubleshooting](./docs/docker-troubleshooting.md) | Common issues and fixes |
 
 ## Contributing
 
-Built in a focused 2-week sprint to demonstrate production-grade AI development tooling.
+We welcome contributions! See [CONTRIBUTING.md](./CONTRIBUTING.md) for guidelines.
 
-Contributions welcome! Areas for improvement:
-- Support for more languages (currently: Python, JS/TS)
-- Advanced graph algorithms (find circular dependencies, suggest refactorings)
-- GitHub integration (PR impact analysis)
-- Team analytics (who writes what patterns)
+**Quick links:**
+- [Open Issues](https://github.com/OpenCodeIntel/opencodeintel/issues)
+- [Good First Issues](https://github.com/OpenCodeIntel/opencodeintel/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22)
 
 ## License
 
-MIT License - use it, fork it, build on it.
-
-## Built With
-
-Commitment to shipping production-grade AI tools. Not a side project. Not a demo. Real infrastructure that scales.
-
----
-
-**Questions?** Open an issue or reach out.
+MIT License - see [LICENSE](./LICENSE) for details.