Sulcus Documentation

# 1. Install the native Rust sulcus binary (includes embedded PostgreSQL 17 + CPU embeddings)
curl -fsSL https://sulcus.ca/install.sh | bash

# 2. Authenticate against Sulcus Cloud, your Private VPC, or run 100% offline
sulcus login

# 3. Wire zero-secret MCP configuration into Junie, RubyMine, VS Code, Claude Code, Codex, or OpenCode
sulcus connect

# 4. Verify workstation identity, dynamic libraries, seat lease, and daemon health
sulcus doctor

// Written automatically by `sulcus connect` (no raw API keys stored in project repos)
{
  "mcpServers": {
    "sulcus": {
      "command": "sulcus",
      "args": ["mcp-proxy"]
    }
  }
}

from sulcus import Sulcus

client = Sulcus(api_key="sk-...")

# Store a standing preference with persistent decay (2.0x half-life) and a heat floor
client.remember(
    "Build release artifacts locally before deploying",
    memory_type="preference",
    decay_class="persistent",
    is_pinned=True,
    min_heat=0.35,
    key_points=["local release builds", "zero server compilation"],
)

# Store a verified architectural fact in a repository namespace
client.remember(
    "Keycloak OIDC RS256 tokens authenticate multi-tenant API sessions",
    memory_type="fact",
    namespace="shared-platform",
)

# Hybrid vector + BM25 + graph resonance recall
results = client.search("authentication and build rules", namespace="shared-platform")
for m in results:
    print(f"[{m.memory_type}] {m.pointer_summary} (heat={m.current_heat:.2f})")

# Explicit relevance feedback reinforces high-signal nodes and trains SIRU
client.feedback(results[0].id, "relevant")

import { Sulcus } from "sulcus";

const client = new Sulcus({ apiKey: process.env.SULCUS_API_KEY! });

await client.remember("Verify Stripe HMAC signatures with constant-time compare", {
  memoryType: "procedural",
  decayClass: "persistent",
  minHeat: 0.25,
  namespace: "payments-rails",
});

// Assemble token-budgeted working context in a single call
const context = await client.buildContext({
  query: "webhook signature verification",
  tokenBudget: 1800,
  namespace: "payments-rails",
});

console.log(context.formattedBlock);