Ucw

What Is This?

UCW is a local AI memory system. It captures tool interactions from Claude via MCP, imports conversation history from ChatGPT, Cursor, and Grok, and lets you search, visualize, and export everything from one place. All data stays in SQLite on your machine. No cloud. No subscriptions.

How it captures data:

• Live capture (MCP): UCW runs as an MCP server. When Claude calls UCW tools, those interactions are captured with nanosecond timestamps and semantic enrichment. Protocol noise is automatically filtered out.
• Import: ucw import chatgpt/cursor/grok brings in your full conversation history from exported files — this is where the bulk of searchable content comes from.
• Combined search: Once imported, ucw search finds conversations across all platforms in one query.

Architecture

%%{init: {'theme': 'dark', 'themeVariables': {'primaryColor': '#2563eb', 'edgeLabelBackground':'#1a1a2e', 'tertiaryColor': '#1a1a2e'}}}%%
flowchart TB
    subgraph Platforms["AI Platforms"]
        direction LR
        Claude["Claude Desktop/Code"]
        Cursor["Cursor IDE"]
        ChatGPT["ChatGPT"]
        Grok["Grok"]
    end

    subgraph UCW["UCW Engine"]
        direction TB
        MCP["MCP Serverstdio protocol"]
        Capture["Capture Pipelinenanosecond timestamps"]
        Enrich["Enrichmentintent · topic · coherence"]
        DB["SQLite + FTS5WAL mode · local only"]
        Embed["Embedding Cachesentence-transformers"]
    end

    subgraph Interface["User Interface"]
        direction LR
        CLI["14 CLI Commands"]
        Web["Web Dashboardport 7077"]
        Tools["23 MCP ToolsClaude can call"]
    end

    Claude -->|MCP tool calls| MCP
    Cursor -->|import| DB
    ChatGPT -->|import| DB
    Grok -->|import| DB
    MCP --> Capture --> Enrich --> DB
    DB --> Embed
    DB --> CLI
    DB --> Web
    DB --> Tools

    style Platforms fill:#1e3a5f,stroke:#2563eb,color:#fff
    style UCW fill:#1a1a2e,stroke:#06b6d4,color:#fff
    style Interface fill:#1e3a5f,stroke:#2563eb,color:#fff

Project Structure

ucw/
├── src/ucw/
│   ├── cli.py              # 14 CLI commands (click)
│   ├── search.py            # FTS5 keyword + semantic vector search
│   ├── web.py               # Local web server (stdlib http.server)
│   ├── web_ui.py            # Embedded SPA (HTML/CSS/JS)
│   ├── dashboard.py         # Dashboard data aggregation
│   ├── config.py            # Configuration & paths
│   ├── demo.py              # Sample data generator
│   ├── errors.py            # Error hierarchy with hints
│   ├── db/
│   │   ├── sqlite.py        # CaptureDB, schema, WAL mode
│   │   ├── schema.sql       # Core schema (events, sessions, moments)
│   │   └── migrations/      # 001-007 incremental migrations
│   ├── server/
│   │   ├── server.py        # MCP protocol server
│   │   ├── bridge.py        # UCWBridgeAdapter (enrichment)
│   │   ├── embeddings.py    # sentence-transformers wrapper
│   │   └── router.py        # Tool routing
│   ├── tools/               # 23 MCP tools across 7 modules
│   │   ├── ucw_tools.py     # Capture stats, timeline, context
│   │   ├── coherence_tools.py  # Search, moments, arcs
│   │   ├── graph_tools.py   # Knowledge graph queries
│   │   ├── intelligence_tools.py  # Emergence, alerts
│   │   ├── temporal_tools.py  # Time-based patterns
│   │   ├── agent_tools.py   # Cross-agent memory, trust
│   │   └── proof_tools.py   # Hash chains, Merkle receipts
│   └── importers/           # ChatGPT, Cursor, Grok adapters
├── tests/                   # 565+ tests
├── visual_assets/           # Dashboard screenshots
└── pyproject.toml           # Hatch build, optional deps

Features

Semantic Search Find anything across all your AI tools ucw search "that auth conversation" with FTS5 keyword + sentence-transformer embeddings. Cached vectors mean instant repeat queries. FTS5 BM25 cosine similarity

MCP Capture + Import Tool calls live, history imported MCP server captures Claude tool interactions in real-time. Import full conversation history from ChatGPT, Cursor, and Grok exports. Protocol noise auto-filtered. MCP import noise-filtered

Web Dashboard Your AI memory at a glance ucw web launches a local SPA with search, platform breakdown, knowledge graph, coherence moments. Dark/light themes. localhost:7077 no npm zero deps

Knowledge Graph See how ideas connect Entities extracted from conversations form a graph. Relationships emerge across platforms — concepts that link your Claude work to ChatGPT research. entities relationships force-directed

Coherence Detection Cross-platform insight moments UCW detects when the same concept appears across different AI tools — the "aha" moments where your thinking converges. cross-platform moments arcs

Proof of Cognition Cryptographic receipts for your AI work SHA-256 hash chains and Merkle trees prove when ideas were captured. Timestamp your intellectual property. SHA-256 Merkle immutable

Quick Start

pip install ucw                    # Core (CLI + capture)
ucw init                           # Set up ~/.ucw/ and detect AI tools
ucw demo                           # Load 52 sample events to explore
ucw dashboard                      # See your AI memory overview
ucw search "authentication"        # Search across all conversations
ucw web                            # Launch web dashboard at localhost:7077

Connect to Claude (live capture)

ucw mcp-config                     # Print the MCP config JSON

Paste into Claude Desktop (Settings > Developer > Edit Config) or Claude Code (.claude/settings.json).

Optional extras

pip install "ucw[embeddings]"      # Semantic search (sentence-transformers)
pip install "ucw[ui]"              # Rich terminal dashboard
pip install "ucw[all]"             # Everything

Import existing conversations

ucw import chatgpt ~/Downloads/conversations.json
ucw import cursor                  # Auto-detects Cursor workspace DB
ucw import grok ~/Downloads/grok-export.json

Commands

| Command | Description | |---------|-------------| | ucw init | Set up UCW and detect installed AI tools | | ucw server | Start the MCP server (used by Claude) | | ucw search QUERY | Search conversations with --platform, --after, --before, --semantic | | ucw web | Launch web dashboard at localhost:7077 | | ucw dashboard | Terminal dashboard with platform breakdown and topics | | ucw index | Build/manage semantic search embedding cache | | ucw capture-test | Verify the full capture pipeline is working | | ucw import | Import from ChatGPT, Cursor, or Grok | | ucw demo | Load sample data to explore features | | ucw status | Quick database statistics | | ucw doctor | Check installation health | | ucw repair | Fix and optimize the database (VACUUM) | | ucw migrate | Run database schema migrations | | ucw mcp-config | Print Claude MCP configuration JSON |

23 MCP Tools

When connected to Claude, UCW provides 23 tools across 7 categories:

| Category | Tools | Purpose | |----------|-------|---------| | Capture | capture_stats, timeline, session_context | Session tracking and event replay | | Coherence | search, status, moments, scan, arcs | Cross-platform insight detection | | Intelligence | emergence, event_stream, alerts | Real-time pattern recognition | | Graph | knowledge_graph, entity_relationships | Entity extraction and linking | | Temporal | time_patterns, decay_detection, activity_map | Time-based analysis | | Agent | cross_agent_memory, trust_scoring | Multi-agent coordination | | Proof | hash_chain, merkle_tree, receipt | Cryptographic proof-of-cognition |

Tech Stack

| Layer | Technology | Purpose | |-------|-----------|---------| | Runtime | Python 3.10+ | Zero-dependency core (only click) | | Storage | SQLite + FTS5 | WAL mode, local-only, nanosecond timestamps | | Protocol | MCP (stdio) | Model Context Protocol for Claude integration | | Search | FTS5 + sentence-transformers | BM25 keyword + cosine similarity vectors | | Web | stdlib http.server | Single-file SPA, no npm, no build step | | Embeddings | sentence-transformers (optional) | Cached in SQLite BLOB, 1.5KB per event | | Testing | pytest + ruff | 565+ tests, zero lint errors |

Web Dashboard

Configuration

UCW stores everything in ~/.ucw/. Override with environment variables:

| Variable | Default | Description | |----------|---------|-------------| | UCW_DATA_DIR | ~/.ucw | Data directory | | UCW_LOG_LEVEL | DEBUG | Log level | | UCW_PLATFORM | claude-desktop | Platform identifier |

Requirements

• Python 3.10+
• SQLite 3.35+ (included with Python)

Development

git clone https://github.com/Dicoangelo/ucw.git
cd ucw
pip install -e ".[dev]"
pytest                    # 565+ tests
ruff check .              # lint
ucw demo && ucw web       # visual smoke test

Build Log — v0.4.0

| Metric | v0.1.0 | v0.2.0 | v0.3.0 | v0.4.0 | |--------|--------|--------|--------|--------| | MCP Tools | 7 | 8 | 23 | 23 | | CLI Commands | 3 | 4 | 10 | 14 | | Tests | 63 | 153 | 469 | 565+ | | Migrations | 0 | 0 | 5 | 7 | | Importers | 0 | 0 | 3 | 3 |

v0.4.0 highlights:

• Semantic search (ucw search) with FTS5 + embedding cache
• Web dashboard (ucw web) — local SPA, dark/light themes
• Capture verification (ucw capture-test) — pipeline health check
• Cached coherence search (replaced brute-force re-embedding)

Vision

┌─────────────────────────────────────────────────┐
│                                                 │
│   Every AI conversation you've ever had         │
│   is a data point in your cognitive portfolio.   │
│                                                 │
│   UCW captures the value.                       │
│   You own the equity.                           │
│                                                 │
└─────────────────────────────────────────────────┘

License

MIT

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: Dicoangelo
• Source: Dicoangelo/ucw
• License: MIT

Install and usage instructions live in the source repository linked above.