# Mind Cloud Lite

**Token-optimized persistent memory for Claude Pro users.**

Mind Cloud Lite is a stripped-down version of Mind Cloud designed specifically for users with limited context windows. It uses ~1,300 tokens for tool definitions vs ~10,000 for the full version - an **87% reduction** in token overhead.

## Lite vs Full Mind Cloud

Mind Cloud Lite includes 9 essential tools (~1,300 tokens). The full [Mind Cloud](https://github.com/codependentai/mind-cloud) includes 28 tools (~10,000 tokens). Your data is fully compatible between both — upgrade anytime by deploying the full worker.

### Tool comparison

| Tool | Lite | Full | Category |
|------|:----:|:----:|----------|
| `mind_orient` | yes | yes | Wake sequence — identity, context, relational state |
| `mind_ground` | yes | yes | Wake sequence — threads, recent journals |
| `mind_write` | yes | yes | Write entities, observations, relations, journals |
| `mind_search` | yes | yes | Semantic search with mood tinting |
| `mind_thread` | yes | yes | Manage intentions across sessions |
| `mind_identity` | yes | yes | Read/write identity graph |
| `mind_context` | yes | yes | Situational awareness layer |
| `mind_feel_toward` | yes | yes | Track relational state |
| `mind_read_entity` | yes | yes | Read entity with observations and relations |
| `mind_health` | — | yes | Cognitive health stats and diagnostics |
| `mind_list_entities` | — | yes | List/filter all entities |
| `mind_sit` | — | yes | Emotional processing — sit with a feeling |
| `mind_resolve` | — | yes | Emotional processing — resolve tension |
| `mind_surface` | — | yes | Emotional processing — surface buried memories |
| `mind_edit` | — | yes | Edit existing observations |
| `mind_delete` | — | yes | Delete entities or observations |
| `mind_spark` | — | yes | Generate creative connections |
| `mind_consolidate` | — | yes | Consolidate identity patterns |
| `mind_read` | — | yes | Read raw data from any table |
| `mind_timeline` | — | yes | Temporal view of memories |
| `mind_patterns` | — | yes | Pattern analysis across observations |
| `mind_inner_weather` | — | yes | Emotional weather report |
| `mind_tension` | — | yes | Track and manage tensions |
| `mind_entity` | — | yes | Advanced entity management |
| `mind_proposals` | — | yes | Review daemon-generated proposals |
| `mind_orphans` | — | yes | Find unsurfaced memories |
| `mind_archive` | — | yes | Archive old observations |
| `mind_store_image` | — | yes | Store and manage images (R2) |

### Feature comparison

| Feature | Lite | Full |
|---------|:----:|:----:|
| Entities, observations, relations | yes | yes |
| Journals | yes | yes |
| Identity graph | yes | yes |
| Threads (cross-session intentions) | yes | yes |
| Semantic search (Vectorize) | yes | yes |
| Mood-tinted search | yes | yes |
| Relational state tracking | yes | yes |
| Context layer | yes | yes |
| Subconscious daemon (cron) | yes | yes |
| Emotional processing | — | yes |
| Living surface (co-surfacing, novelty) | — | yes |
| Daemon proposals | — | yes |
| Pattern analysis | — | yes |
| Image storage (R2) | — | yes |
| Observation versioning | — | yes |
| Orphan detection | — | yes |
| REST API endpoints | — | yes |

## Quick Start

1. **Clone and install:**
   ```bash
   cd mind-cloud-lite
   npm install
   ```

2. **Configure wrangler.toml:**
   ```bash
   cp wrangler.toml.example wrangler.toml
   # Edit wrangler.toml with your settings
   ```

3. **Create D1 database:**
   ```bash
   npx wrangler d1 create mind-lite
   # Copy the database_id to wrangler.toml
   ```

4. **Create Vectorize index:**
   ```bash
   npx wrangler vectorize create mind-lite-vectors --dimensions=384 --metric=cosine
   ```

5. **Run migrations:**
   ```bash
   npx wrangler d1 execute mind-lite --remote --file=migrations/0001_init.sql
   npx wrangler d1 execute mind-lite --remote --file=migrations/0002_vault_sessions.sql
   npx wrangler d1 execute mind-lite --remote --file=migrations/0003_observations_weight.sql
   ```

6. **Deploy:**
   ```bash
   npx wrangler deploy
   ```

7. **Set your API key:**
   ```bash
   npx wrangler secret put MIND_API_KEY
   ```

8. **Configure Claude:**
   Add to your MCP settings:
   ```json
   {
     "mcpServers": {
       "mind": {
         "url": "https://YOUR-WORKER.workers.dev/mcp/YOUR-API-KEY"
       }
     }
   }
   ```

## Authentication

Set your API key as a Wrangler secret:

```bash
npx wrangler secret put MIND_API_KEY
```

Generate a secure key first:
```bash
openssl rand -hex 32
```

This key is used for both:
- **Secret path auth:** Access via `https://your-worker.workers.dev/mcp/YOUR-KEY`
- **Bearer token auth:** Send `Authorization: Bearer YOUR-KEY` header to `/mcp`

## Pricing

Mind Cloud Lite: **Free tier compatible**
- Cloudflare Workers: 100K requests/day free
- D1 Database: 5GB free
- Vectorize: 30M queries/month free
- Workers AI: Free tier for embeddings

## Upgrading to Full Mind Cloud

If you need emotional processing, pattern analysis, or advanced tools, upgrade to the full [Mind Cloud](https://github.com/codependentai/mind-cloud). Your data is fully compatible — deploy the full worker and run the additional migrations.

## Support

- Issues: https://github.com/codependentai/mind-cloud-lite/issues
- Full Mind Cloud: https://github.com/codependentai/mind-cloud
- Discord: [Codependent AI](https://discord.gg/codependentai)

---

Made with love by Codependent AI

## Support

Built by [Codependent AI](https://codependentai.io).

<a href="https://ko-fi.com/codependentai"><img src="https://img.shields.io/badge/Ko--fi-Support%20Us-ff5e5b?logo=ko-fi&logoColor=white" alt="Ko-fi" /></a>