# FivoCell

> **Your AI forgets. Cell doesn't.**

[![License](https://img.shields.io/badge/License-Apache%202.0-blue)](LICENSE)
[![Platform](https://img.shields.io/badge/Mac%20%7C%20Windows%20%7C%20Linux-supported-lightgrey)]()
[![Node](https://img.shields.io/badge/Node-%3E%3D18-green)]()
[![npm](https://img.shields.io/npm/v/fivocell)](https://www.npmjs.com/package/fivocell)
[![Tests](https://img.shields.io/badge/Tests-817%2F817-passing-brightgreen)]()

---

## The Problem

Every AI coding session starts from zero.

You explain your stack. Your style. Your last decision. Your project goals.  
Switch from Cursor to Codex? Start over. New chat? Start over. New day? Start over.

**AI tools write code. But they forget everything between sessions.**

---

## The Solution

Cell creates a permanent intelligence layer between you and every AI tool.

```
                ┌──────────┐
Cursor ────────→│          │
Claude Code ───→│   CELL   │────→ SQLite (100% local)
Codex ─────────→│          │
Antigravity ───→│  Memory  │────→ Never forgets. Never resets.
Windsurf ──────→│          │
Any MCP tool ──→└──────────┘
```

One daemon. One database. One memory. Works across every AI tool.

---

## 30-Second Start

```bash
npm i -g fivocell --loglevel=error
cell setup
cell start
cell mcp-config
```

Type `@cell` in Cursor, Codex, Antigravity, or any MCP tool. AI gets full project memory.

---

## What Cell Remembers

| Your AI Tool | Cell Adds |
|-------------|-----------|
| Writes code | **Remembers your project** — stack, files, architecture |
| Generates functions | **Knows your style** — quotes, naming, patterns (auto-detected) |
| Answers questions | **Recalls your decisions** — why you chose PostgreSQL, not Mongo |
| Opens new chat | **Restores your session** — what you were working on, where you left off |
| Switches between tools | **Same memory everywhere** — Cursor → Codex → Claude, no loss |
| Responds generically | **Adapts to your vibe** — your language, your tone, your workflow |

---

## Core Features

### 🎯 @cell Context Injection
Type `@cell` in any AI tool. Cell injects your project profile, coding style, blind spots, last session, and predictions. AI never starts from zero again.

### 🧠 Permanent Memory
Decisions, errors, fixes, patterns — everything stored in local SQLite. Searchable. Replayable. Survives sessions, tools, and time.

### 🔍 Blind Spot Scanner
Automatically detects 15+ code issues: missing null checks, swallowed errors, `any` usage, N+1 queries, deep nesting. Prioritized. Actionable.

### 🎭 Vibe Engine (NEW in v7)
Cell learns how you work — your language, your tone, your preferences. Hinglish or English? Bullets or paragraphs? Minimal changes or thorough rewrites? AI adapts automatically.

### 🔗 Cross-Tool Memory
Same daemon, same database, same memory. Works with Cursor, Codex, Antigravity, Claude Code, Windsurf, OpenCode, and any MCP client.

### 🌐 Local-First & Private
Everything runs on your machine. No cloud. No telemetry. No tracking. AES-256-GCM encryption for sensitive data. Apache 2.0 — free forever.

### 🩺 Health System
`cell doctor` runs 12 checks across all subsystems. `cell verify` ensures data integrity. Critical issues flagged. Warnings explained. Always know your memory health.

---

## Why Cell vs The Alternatives

| Problem | AI Tools Alone | With Cell |
|---------|---------------|-----------|
| Project context per session | ❌ Re-explain every time | ✅ Auto-injected |
| Memory across tools | ❌ Each tool isolated | ✅ One memory, all tools |
| Code style consistency | ❌ Manual rules files | ✅ Auto-detected + injected |
| Blind spots & risks | ❌ Hope AI catches them | ✅ Systematic scanner |
| Session handoff | ❌ Lost on tool switch | ✅ Seamless bridge |
| Developer personality | ❌ Generic responses | ✅ Vibe — adapts to you |
| Privacy | ❌ Cloud-dependent | ✅ 100% local |

---

## Quick Commands

```
cell setup         One-time setup
cell start         Start daemon on localhost:9876
cell scan          Analyze codebase + build intelligence
cell context       View what @cell returns
cell blindspots    Find code issues (--top for quick view)
cell vibe          See your learned personality
cell teach         Tell Cell about yourself
cell doctor        12-point health check
cell verify        Data integrity check
cell memory search Search everything Cell remembers
```

---

## Supported Tools

| Tool | Connection | Setup |
|------|-----------|-------|
| **Cursor** | MCP | `cell mcp-config` |
| **Codex** | MCP | `cell mcp-config` |
| **Antigravity** | MCP | `cell mcp-config` |
| **Claude Code** | MCP | Manual URL |
| **Windsurf** | MCP | Manual URL |
| **OpenCode** | MCP | `cell mcp-config` |
| **GitHub Copilot** | MCP | Manual URL |
| **VS Code** | Extension | Install VSIX |
| **Any MCP Client** | HTTP | `http://localhost:9876/mcp` |

---

## What Users Are Saying

> "Finally — I switch between Cursor and Codex all day. Cell keeps my context. I don't explain anything twice anymore."

> "The blind spot scanner found 39 async functions without try/catch in my codebase. I fixed them in an hour. That alone saved me weeks of debugging."

> "My AI now talks in Hinglish. Not because I asked — Cell figured it out from my sessions. The vibe engine is actually magic."

---

## More Features

Cell also includes: session replay, branch context memory, CI/CD integration, encrypted sync export/import, weekly reports, memory health scoring, developer velocity tracking, knowledge graph, project DNA fingerprinting, focus reports, PR review assistant, and 70+ more. See [full reference](docs/FIVO-CELL-COMPLETE-REFERENCE.md).

---

## Architecture

```
~/.fivo/cell/cell.db    ← Single SQLite database (64 tables)
  ├── memory_events     ← Every edit, decision, error, fix
  ├── sessions          ← Work sessions across all tools
  ├── style_profiles    ← Auto-detected coding patterns
  ├── code_patterns     ← Learned patterns by category
  └── ... (60+ more tables)

.cell/                   ← Per-project readable files
  ├── vibe/              ← Your learned personality (new in v7)
  ├── memory/            ← Compressed archives + summaries
  └── handoff/           ← Session-to-session context
```

---

## Stats

```
✅ Build:      0 TypeScript errors
✅ Tests:      86 suites, 817/817 passing
✅ MCP Tools:  112 registered
✅ Lines:      59,000+ production TypeScript
✅ Security:   0 vulnerabilities (audited 2026-06-13)
```

---

## Contribute

[github.com/itsvinsoni/fivocell](https://github.com/itsvinsoni/fivocell)

Apache 2.0. Open issues. PRs welcome.

---

**AI tools come and go. Your project knowledge stays.**
