@pella-labs/pinakes 0.1.0 → 0.1.1

package/README.md

@@ -1,4 +1,4 @@
-# kg-mcp
+# @pella-labs/pinakes
 
 Local stdio MCP server that indexes a [Karpathy-style](https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f) two-level knowledge wiki (project + personal) into SQLite and exposes it to any coding LLM via [Cloudflare-style code-mode](https://blog.cloudflare.com/code-mode-mcp/).
 
@@ -9,37 +9,14 @@ Local stdio MCP server that indexes a [Karpathy-style](https://gist.github.com/k
 
 Markdown is canonical. SQLite is the index. If the index is corrupted or lost, rebuild it from markdown.
 
-## Install
-
-```bash
-# Clone and build
-git clone <repo-url> && cd knowledge-graph
-pnpm install
-pnpm run build
-```
-
-Requires **Node.js 24 LTS** (`^24.10.0`) and **pnpm** (`>=10.30.0`).
-
-## Quick start
-
-```bash
-# Initialize a wiki directory
-mkdir -p .kg/wiki
-echo "# My Project\nSome knowledge about the project." > .kg/wiki/overview.md
-
-# Start the stdio server
-pnpm run kg -- serve --wiki-path .kg/wiki
+Requires **Node.js 24 LTS** (`^24.10.0`).
 
-# Or rebuild the index from existing markdown
-pnpm run kg -- rebuild --wiki-path .kg/wiki
-```
-
-## MCP client configuration
+## Install
 
 ### Claude Code
 
 ```bash
-claude mcp add kg-mcp -- npx tsx /path/to/knowledge-graph/src/cli/index.ts serve --wiki-path /path/to/project/.kg/wiki
+claude mcp add pinakes -- npx @pella-labs/pinakes serve --wiki-path ./wiki
 ```
 
 Or add to `.claude/settings.json`:
@@ -47,9 +24,9 @@ Or add to `.claude/settings.json`:
 ```json
 {
   "mcpServers": {
-    "kg-mcp": {
+    "pinakes": {
       "command": "npx",
-      "args": ["tsx", "/path/to/knowledge-graph/src/cli/index.ts", "serve", "--wiki-path", "/path/to/project/.kg/wiki"]
+      "args": ["@pella-labs/pinakes", "serve", "--wiki-path", "./wiki"]
     }
   }
 }
@@ -61,22 +38,21 @@ Add to `~/.config/goose/profiles.yaml`:
 
 ```yaml
 extensions:
-  kg-mcp:
-    name: kg-mcp
+  pinakes:
+    name: pinakes
     type: stdio
     cmd: npx
     args:
-      - tsx
-      - /path/to/knowledge-graph/src/cli/index.ts
+      - "@pella-labs/pinakes"
       - serve
       - --wiki-path
-      - /path/to/project/.kg/wiki
+      - ./wiki
 ```
 
 ### Codex
 
 ```bash
-export CODEX_MCP_SERVERS='{"kg-mcp":{"command":"npx","args":["tsx","/path/to/knowledge-graph/src/cli/index.ts","serve","--wiki-path","/path/to/project/.kg/wiki"]}}'
+export CODEX_MCP_SERVERS='{"pinakes":{"command":"npx","args":["@pella-labs/pinakes","serve","--wiki-path","./wiki"]}}'
 ```
 
 ### OpenCode
@@ -86,9 +62,9 @@ Add to `opencode.json`:
 ```json
 {
   "mcp": {
-    "kg-mcp": {
+    "pinakes": {
       "command": "npx",
-      "args": ["tsx", "/path/to/knowledge-graph/src/cli/index.ts", "serve", "--wiki-path", "/path/to/project/.kg/wiki"]
+      "args": ["@pella-labs/pinakes", "serve", "--wiki-path", "./wiki"]
     }
   }
 }
@@ -101,14 +77,27 @@ Add to Cursor settings (Settings > MCP Servers):
 ```json
 {
   "mcpServers": {
-    "kg-mcp": {
+    "pinakes": {
       "command": "npx",
-      "args": ["tsx", "/path/to/knowledge-graph/src/cli/index.ts", "serve", "--wiki-path", "/path/to/project/.kg/wiki"]
+      "args": ["@pella-labs/pinakes", "serve", "--wiki-path", "./wiki"]
     }
   }
 }
 ```
 
+## Quick start
+
+```bash
+# Create a wiki directory in your project
+mkdir -p wiki
+echo "# My Project" > wiki/overview.md
+
+# Test it directly
+npx @pella-labs/pinakes serve --wiki-path ./wiki
+```
+
+The server indexes all `.md` files in the wiki directory, watches for changes, and serves them over stdio.
+
 ## Example queries
 
 ### Search
@@ -120,6 +109,9 @@ kg_search({ query: "authentication flow", scope: "project" })
 ### Execute (code-mode)
 
 ```javascript
+// Browse the wiki index
+kg_execute({ code: `return kg.project.index()` })
+
 // Full-text search
 kg_execute({ code: `return kg.project.fts("bcrypt")` })
 
@@ -145,18 +137,18 @@ kg_execute({
 ## CLI commands
 
 ```bash
-kg serve   --wiki-path <dir>     # Start the stdio MCP server
-kg rebuild --wiki-path <dir>     # Full rebuild from markdown
-kg status                        # Health check + row counts
-kg audit   [--tail] [--n 20]     # Tail the audit log
-kg purge   --scope <s> --confirm # Delete a scope's DB
-kg export  --scope <s> [--out f] # Dump nodes + edges as JSON
-kg import  --scope <s> --in f    # Restore from dump
+npx @pella-labs/pinakes serve   --wiki-path <dir>     # Start the stdio MCP server
+npx @pella-labs/pinakes rebuild --wiki-path <dir>     # Full rebuild from markdown
+npx @pella-labs/pinakes status                        # Health check + row counts
+npx @pella-labs/pinakes audit   [--tail] [--n 20]     # Tail the audit log
+npx @pella-labs/pinakes purge   --scope <s> --confirm # Delete a scope's DB
+npx @pella-labs/pinakes export  --scope <s> [--out f] # Dump nodes + edges as JSON
+npx @pella-labs/pinakes import  --scope <s> --in f    # Restore from dump
 ```
 
 ## Embedder configuration
 
-The default embedder is bundled (`Xenova/all-MiniLM-L6-v2`, 384 dimensions, runs locally). You can upgrade to a more capable embedder via environment variables:
+The default embedder is bundled (`Xenova/all-MiniLM-L6-v2`, 384 dimensions, runs locally). You can upgrade via environment variables:
 
 ### Ollama (local, free)
 
@@ -180,13 +172,13 @@ export KG_EMBED_PROVIDER=openai
 export KG_OPENAI_API_KEY=your-key-here
 ```
 
-Changing the embedder requires a full rebuild (`kg rebuild`) since the vector dimensions change.
+Changing the embedder requires a full rebuild (`pinakes rebuild`) since the vector dimensions change.
 
 ## Architecture
 
 - **Single process**: MCP server, file watcher, SQLite writer, read pool, embedder, and QuickJS sandbox all in one Node process
 - **Single writer, multi reader**: one writer connection + 2 reader connections per DB, WAL mode
-- **Two-level KG**: project wiki (`.kg/wiki/`) + personal wiki (`~/.kg/wiki/`), fully isolated by default
+- **Two-level KG**: project wiki (`./wiki/`) + personal wiki (`~/.kg/wiki/`), fully isolated by default
 - **Privacy invariant**: personal KG bindings are only injected when `scope` includes `'personal'`
 - **Budget gate**: every response stays under `max_tokens` (default 5000, hard cap 25000)
 - **Deterministic IDs**: `sha1(scope + ':' + source_uri + ':' + section_path)` means re-indexing is idempotent
@@ -194,6 +186,7 @@ Changing the embedder requires a full rebuild (`kg rebuild`) since the vector di
 ## Development
 
 ```bash
+git clone <repo-url> && cd knowledge-graph
 pnpm install
 pnpm run dev              # Watch mode
 pnpm run test             # Run tests (vitest)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pella-labs/pinakes",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Local stdio MCP server that indexes a Karpathy-style two-level knowledge wiki into SQLite and exposes it to a coding LLM via Cloudflare-style code-mode.",
   "type": "module",
   "bin": {
@@ -44,7 +44,7 @@
     "vitest": "^2.1.0"
   },
   "scripts": {
-    "build": "tsc",
+    "build": "tsc && chmod +x dist/cli/index.js",
     "dev": "tsx watch src/server.ts",
     "lint": "eslint src",
     "typecheck": "tsc --noEmit",