@dtoolkit/dbrain 0.2.1 → 0.2.2

package/README.md

@@ -1,33 +1,34 @@
 <p align="center">
-  <img src="logo.png" alt="dbrain" width="600">
+  <img src="logo.png" alt="dbrain" />
 </p>
 
+<h1 align="center">@dtoolkit/dbrain</h1>
+<p align="center">Your distributed mind. Persistent knowledge across all your AIs.</p>
+
 <p align="center">
-  <a href="https://www.npmjs.com/package/dbrain"><img src="https://img.shields.io/npm/v/dbrain?style=for-the-badge" alt="npm"></a>
-  <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg?style=for-the-badge" alt="License"></a>
-  <a href="https://nodejs.org"><img src="https://img.shields.io/badge/node-%3E%3D20-green?style=for-the-badge" alt="Node"></a>
+  <a href="https://www.npmjs.com/package/@dtoolkit/dbrain"><img src="https://img.shields.io/npm/v/@dtoolkit/dbrain.svg" alt="npm"></a>
+  <a href="../../LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="License"></a>
 </p>
 
----
-
-Every AI conversation starts from zero. Switch machines, switch apps, and your AI forgets everything. **dbrain** fixes that.
-
 Install it once, connect every AI you use — Claude Code at home, Claude Code at work, Gemini on your phone. All share the same identity, the same memories, the same knowledge.
 
 ```
 [Home]   Claude Code ──MCP──┐
 [Work]   Claude Code ──MCP──┤     ┌─────────────────────────────────┐
 [Mobile] Gemini ──REST──────┼────→│  dbrain (your mind)             │
-[Server] OpenClaw ──REST────┤     │  identity + memory + knowledge. │
+[Server] OpenClaw ──REST────┤     │  identity + memory + knowledge  │
 [Other]  Custom AI ──API────┘     └─────────────────────────────────┘
 ```
 
-Not an AI agent. Not an assistant. Not a model. **Just memory** — structured, searchable, persistent.
+## Install
+
+```bash
+npm install -g @dtoolkit/dbrain
+```
 
-## Quick Start
+## Quick start
 
 ```bash
-npm install -g dbrain
 dbrain init       # interactive wizard — creates DB, config, identity
 dbrain start      # starts API on :7878 + dashboard on :7879
 ```
@@ -38,46 +39,9 @@ Then connect Claude Code from any machine:
 dbrain connect claude
 ```
 
-The wizard asks for the brain URL and token (shown during `init`):
-
-```
-┌  dbrain — Connect to a brain
-│
-◇  Brain URL
-│  http://localhost:7878
-│
-◇  Access token
-│  sk-dbr_...
-│
-◇  Brain found
-│
-●  Brain: dBrain — 2 entities, 0 facts
-│
-◇  Claude Code configured
-│
-◇  Files updated ──────────────────────────────────────────────╮
-│                                                              │
-│  ~/.claude.json          MCP server registered               │
-│  ~/.claude/settings.json  Permissions granted                │
-│  ~/.claude/CLAUDE.md      Behavioral instructions installed  │
-│                                                              │
-├──────────────────────────────────────────────────────────────╯
-│
-└  Connected. Restart Claude Code to activate.
-```
-
-Restart Claude Code and it will start using the brain. You can also skip the wizard:
-
-```bash
-dbrain connect claude http://your-server:7878 --token=sk-dbr_...
-```
-
 ## Docker
 
 ```bash
-git clone https://github.com/ivncmp/dbrain.git
-cd dbrain
-cp .env.example .env    # edit token, names, port
 docker compose up -d
 ```
 
@@ -87,7 +51,7 @@ Then from any client machine:
 dbrain connect claude http://your-server:7878
 ```
 
-## How It Works
+## How it works
 
 The brain has 4 layers:
 
@@ -98,7 +62,7 @@ The brain has 4 layers:
 | **Knowledge**     | Structured facts organized by PARA                    | `entities` + `facts` tables with hot/warm/cold tiers |
 | **Recall**        | Full-text search over all facts                       | FTS5 with OR logic for multi-language queries        |
 
-### Memory Tiers
+### Memory tiers
 
 Memories fade if you don't use them — like a real brain.
 
@@ -108,11 +72,7 @@ Memories fade if you don't use them — like a real brain.
 | **warm** | 8–30 days since last access                       |
 | **cold** | > 30 days — fading, candidate for archival        |
 
-Every search bumps accessed facts back to hot. The brain stays sharp on what matters.
-
-## MCP Tools
-
-Available to any MCP client (Claude Code, etc.):
+## MCP tools
 
 | Tool            | Purpose                                     |
 | --------------- | ------------------------------------------- |
@@ -142,20 +102,18 @@ All endpoints require `Authorization: Bearer <token>` except `/health`.
 | `POST`            | `/search`             | Full-text search over all facts                |
 | `GET`             | `/memory/summary`     | Overview: entities x tiers                     |
 
-## CLI Commands
-
-| Command                | Where  | Purpose                                   |
-| ---------------------- | ------ | ----------------------------------------- |
-| `dbrain init [path]`   | Server | Create a new brain (DB, config, identity) |
-| `dbrain start [path]`  | Server | Start the API server + dashboard          |
-| `dbrain connect <client> [url]` | Client | Connect a client to a running brain |
-| `dbrain status [path]` | Server | Check brain status                        |
+## CLI commands
 
-`init` runs on the **server** (creates the brain). `connect` runs on the **client** (configures Claude Code). The brain serves its own client config via `GET /connect`.
+| Command                          | Where  | Purpose                                   |
+| -------------------------------- | ------ | ----------------------------------------- |
+| `dbrain init [path]`             | Server | Create a new brain (DB, config, identity) |
+| `dbrain start [path]`            | Server | Start the API server + dashboard          |
+| `dbrain connect <client> [url]`  | Client | Connect a client to a running brain       |
+| `dbrain status [path]`           | Server | Check brain status                        |
 
 ## Dashboard
 
-Web dashboard on port `7879`. Shows brain stats, entities with PARA categories, fact tiers, conversations, and full-text search. Single-file React app — no build step.
+Web dashboard on port `7879`. Shows brain stats, entities with PARA categories, fact tiers, conversations, and full-text search.
 
 ## Stack
 
@@ -169,28 +127,7 @@ Web dashboard on port `7879`. Shows brain stats, entities with PARA categories,
 | CLI        | @clack/prompts                             |
 | Dashboard  | React 18 (CDN, no build step)              |
 
-## Development
-
-```bash
-git clone https://github.com/ivncmp/dbrain.git
-cd dbrain
-npm install              # installs deps + builds (prepare script)
-npx dbrain init          # create a brain (only needed once)
-npm run dev              # starts the server with file watching
-```
-
-| Script               | What it does                             |
-| -------------------- | ---------------------------------------- |
-| `npm run dev`        | Dev server with file watching (tsx)      |
-| `npm run build`      | Compile TypeScript + copy dashboard HTML |
-| `npm start`          | Start the compiled server from `dist/`   |
-| `npm test`           | Run tests with vitest                    |
-| `npm run lint`       | ESLint check                             |
-| `npm run lint:fix`   | ESLint auto-fix                          |
-| `npm run format`     | Prettier format                          |
-| `npm run check`      | Lint + format + build (full pipeline)    |
-
-## Environment Variables
+## Environment variables
 
 For non-interactive setup (Docker, CI):
 
@@ -206,4 +143,4 @@ For non-interactive setup (Docker, CI):
 
 ## License
 
-[MIT](LICENSE)
+[MIT](../../LICENSE)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dtoolkit/dbrain",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "Your distributed mind. Persistent knowledge across all your AIs.",
   "type": "module",
   "license": "MIT",