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");

MCP smoke test (call wiki_capture then wiki_search via your MCP client):

Tool: wiki_capture
Args: { content: "smoke-test: sage-wiki integration works at {timestamp}" }
Expected: confirmation text, no error

Tool: wiki_search
Args: { query: "smoke-test sage-wiki integration" }
Expected: at least one result, no error

Step 4: Run the smoke test

Execute the chosen smoke test. If it fails:

• Check the server is running (sage-wiki serve --ui)
• Verify the token is correct (if auth is enabled)
• Check the server logs for errors

Step 5: Report

After a successful smoke test, confirm:

• sage-wiki is connected and reachable
• The chosen integration path works
• Store → search → verify cycle completes

Then refer to the sage-wiki reference skill for the full tool catalog, error codes, and opt-in features.

Pre-1.0 notice: Every surface here is experimental. Tool semantics, argument names, and REST routes may change between versions. Pin the version you depend on.

Generated by tools/skillgen — reference skill covers 19 tools.