@pella-labs/pinakes 0.1.0 → 0.1.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Pella Labs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

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 https://github.com/pella-labs/pinakes.git && cd pinakes
 pnpm install
 pnpm run dev              # Watch mode
 pnpm run test             # Run tests (vitest)
@@ -205,4 +198,4 @@ pnpm run lint             # eslint
 
 ## License
 
-See LICENSE file.
+[MIT](LICENSE)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pella-labs/pinakes",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "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",
@@ -55,6 +55,7 @@
     "test:budget": "vitest run src/__tests__/budget --passWithNoTests",
     "db:migrate": "drizzle-kit migrate",
     "db:generate": "drizzle-kit generate",
-    "kg": "tsx src/cli/index.ts"
+    "kg": "tsx src/cli/index.ts",
+    "publish:npm": "pnpm publish --access public"
   }
 }