<div align="center">

# Zero Friction (0f)

### Switch inter AI tools without losing context with zero friction.

[![CI](https://github.com/zanarellidev/0f/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/zanarellidev/0f/actions/workflows/ci.yml)
[![Pages](https://github.com/zanarellidev/0f/actions/workflows/deploy-pages.yml/badge.svg?branch=main)](https://github.com/zanarellidev/0f/actions/workflows/deploy-pages.yml)
[![OpenSSF Scorecard](https://github.com/zanarellidev/0f/actions/workflows/scorecard.yml/badge.svg?branch=main)](https://github.com/zanarellidev/0f/actions/workflows/scorecard.yml)
[![License: Apache-2.0](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](LICENSE)
[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](CONTRIBUTING.md)

*The universal, local-first memory hub and Model Context Protocol (MCP) daemon for AI coding agents.*

[English](README.md) · [Português](README.pt-BR.md) · [Español](README.es.md) · [Français](README.fr.md) · [Deutsch](README.de.md) · [Русский](README.ru.md) · [中文](README.zh-CN.md) · [日本語](README.ja.md) · [한국어](README.ko.md)

---

### 🌐 [**Live Web Dashboard**](https://zanarellidev.github.io/0f/)

[Web Dashboard](https://zanarellidev.github.io/0f/) · [MCP Setup Guide](docs/MCP_INTEGRATION.md) · [Architecture](docs/ARCHITECTURE.md) · [Charter](CHARTER.md)

</div>

---

## ⚡ The Zero Friction (0f) Mission

When you switch between AI coding assistants, you shouldn't have to re-explain your architecture, re-teach your rules, or lose track of past decisions. 

**Zero Friction (0f)** provides a single, local-first daemon and Model Context Protocol (MCP) server so all your AI tools share the same brain:

```
                  ┌──────────────────────────────────────────────┐
                  │          Your Developer Machine              │
                  └──────────────────────┬───────────────────────┘
                                         │
       ┌───────────────────┬─────────────┴───────┬───────────────────┐
       ▼                   ▼                     ▼                   ▼
[ Claude Code ]      [ Cursor IDE ]      [ Antigravity / AGY ]   [ Windsurf ]
       │                   │                     │                   │
       └───────────────────┴─────────────┬───────┴───────────────────┘
                                         │ Standard MCP (stdio)
                                         ▼
                  ┌──────────────────────────────────────────────┐
                  │              Zero Friction (0f)              │
                  ├──────────────────────────────┬───────────────┤
                  │ 🧠 LanceDB Hybrid Memory     │ 🕸️ SQLite     │
                  │    (Dense Vectors + BM25)    │    Knowledge  │
                  │                              │    Graph      │
                  └──────────────────────────────┴───────────────┘
```

---

## 🏛️ 3-Tier Storage Architecture

```
┌─────────────────────────────────────────────────────────────┐
│                 Zero Friction Storage Engine                │
├─────────────────┬─────────────────────────┬─────────────────┤
│ Tier 1: Local   │ Tier 2: Teams (Git)     │ Tier 3: AWS     │
│ (Individual)    │ (Engineering Teams)     │ (Enterprise)    │
├─────────────────┼─────────────────────────┼─────────────────┤
│ • Zero setup    │ • Git repo sync         │ • AWS S3 Arrow  │
│ • Local LanceDB │ • Automatic Markdown ADR│ • DynamoDB Graph│
│ • ~/.0f/ storage│ • Audit trail via PRs   │ • KMS Encryption│
└─────────────────┴─────────────────────────┴─────────────────┘
```

1. **Tier 1 (Individual / Local-First)**: Stored locally in `~/.0f/` with LanceDB & SQLite. 100% private, zero setup.
2. **Tier 2 (Teams / Git-Backed)**: Sincronize memories across your team using any private Git repository (`0f sync --tier git --remote <git_url>`). Generates human-readable Markdown ADRs automatically.
3. **Tier 3 (Enterprise / Managed Cloud)**: High-scale AWS cloud storage plugin (`0f cloud-init aws`) using S3 for vector partitions with KMS encryption and DynamoDB/Aurora for graph topologies.

---

## 🚀 `0f` Command Line Tool

```bash
# 1. Store an architectural decision (ADR) or memory
0f remember "ADR-001: Adopt gRPC" "We choose gRPC for low-latency microservice RPC." --tag grpc --tag architecture

# 2. Recall context semantically across your memories
0f recall "how do we communicate between microservices?"

# 3. Inspect storage tiers (Tier 1 Local, Tier 2 Git, Tier 3 AWS)
0f tiers

# 4. Sync memories with your team's Git repo
0f sync --tier git --remote git@github.com:myorg/team-memory.git

# 5. Export AWS Terraform self-provisioning module
0f cloud-init aws --dest ./terraform-0f

# 6. Inspect knowledge graph topology
0f graph

# 7. Check local hub health & storage
0f status

# 8. Start Model Context Protocol (MCP) server
0f mcp
```

---

## 🔌 Connect to Claude / Cursor / AGY (MCP Setup)

Add `0f` to your `claude_desktop_config.json` or Cursor MCP settings:

```json
{
  "mcpServers": {
    "0f": {
      "command": "0f",
      "args": ["mcp"]
    }
  }
}
```

Now any AI agent can call `remember_context`, `recall_context`, and `list_adrs` automatically!

---

## 📄 License

Distributed under the **Apache 2.0 License**. See [`LICENSE`](LICENSE) for details.