sage-wiki-integrate

sage-wiki-integrate

Wires sage-wiki into an existing repository so the coding assistant can store and retrieve knowledge with provenance. Test-first — every step is verified before proceeding.

Step 1: Detect language

Check the project root for language markers:

Marker	Language	Integration path
pyproject.toml	Python	pip install sagewiki (Python client, P4-3)
package.json	TypeScript / JavaScript	npm install sagewiki (TypeScript client, P4-4)
Neither	Any	MCP stdio config

Step 2: Choose integration path

Python (pyproject.toml found)

pip install sagewiki

from sagewiki import Client

client = Client(base_url="http://localhost:3333/v1")
# If token-protected:
# client = Client(base_url="http://localhost:3333/v1", token="s3cret")

TypeScript (package.json found)

npm install sagewiki

import { Client } from "sagewiki";

const client = new Client({ baseUrl: "http://localhost:3333/v1" });
// If token-protected:
// const client = new Client({ baseUrl: "http://localhost:3333/v1", token: "s3cret" });

Neither (MCP stdio)

Add to the project's MCP config:

{
  "mcpServers": {
    "sage-wiki": {
      "command": "sage-wiki",
      "args": ["serve", "--transport", "stdio", "--project", "."]
    }
  }
}

Step 3: Write a smoke test

Store a fact, search for it, verify it comes back:

Python smoke test:

# Store a fact via capture
resp = client.capture(content="smoke-test: sage-wiki integration works at {now}")
assert resp.status == "ok"

# Search for it
results = client.search(query="smoke-test sage-wiki integration")
assert len(results) > 0, "smoke test failed: no results for stored fact"
print("PASS: smoke test")

TypeScript smoke test:

const resp = await client.capture({ content: "smoke-test: sage-wiki integration works" });
const results = await client.search({ query: "smoke-test sage-wiki integration" });
console.assert(results.length > 0, "smoke test failed");
console.log("PASS: smoke test");