Workstation Ecosystem

Harnesses And SDKs

sulcus connect wires 11 native CLI and IDE harnesses automatically (Antigravity, Claude Code, Cursor, Gemini CLI, Codex, VS Code, Junie, Windsurf, Cline, OpenCode, and Zed), paired with MIT open-source editor plugins and 6 official SDK and framework integrations (17+ ecosystem targets).

Eleven Connect CLIsPure Rust HooksZero Repo SecretsMIT Client SDKs
Hook Architecture

How Harnesses Connect

Unlike brittle shell scripts or secret-leaking JSON configs, Sulcus compiles both MCP stdio proxying and <15ms lifecycle hooks directly into the native Rust binary.

Step One

Authenticate Seat

Run sulcus login once to persist 0600 credentials in ~/.config/sulcus/sulcus.ini or macOS Keychain.

Step Two

Wire Harnesses

Run sulcus connect to register zero-secret sulcus mcp-proxy and sulcus hook entries across IDEs and CLIs.

Step Three

Hydrate Context

PreInvocation hooks inject <sulcus-memories>, <sulcus-peers>, and <sulcus-namespaces> in under 25ms.

Step Four

Record And Curate

PostToolUse snapshots SHA-256 ledger diffs while Stop distills durable lessons through System 1 VCR.

bashWorkstation Harness Wiring
# Auto-detect current repository harnesses (.junie, .idea, .claude, .codex, opencode.json, .vscode)
sulcus connect

# Wire a specific harness and bind a shared cross-repo linked namespace in one step
sulcus connect agy --link shared-platform
sulcus connect junie
sulcus connect claude-code --global
sulcus connect all

# Pure-Rust lifecycle hook invoked automatically by connected harnesses (<15ms cold startup)
sulcus hook agy PreInvocation
Editor Integrations

Native Harness Catalog

Authenticate once, then switch freely across IDEs and terminal agents on the same workstation seat.

VS Code Extension

IDE Extension

Native sidebar Memory Explorer, inline salience badges, Agent Bus collision alerts, Activity Ledger undo, and automatic workstation machine_id binding.

plugins/sulcus-vscode · v1.1.0
sulcus connect vscode

JetBrains Suite

IDE Plugin

IntelliJ 2024.3+ and 2025.1+ plugin for RubyMine, IntelliJ IDEA, PyCharm, WebStorm, RustRover, GoLand, and CLion with RSpec and Rake output compaction.

plugins/sulcus-jetbrains · v1.1.0
sulcus connect jetbrains

JetBrains Junie

Autonomous CLI

Pure-Rust lifecycle hooks (.junie/hooks.json via sulcus hook) plus zero-secret sulcus mcp-proxy wiring (.junie/mcp/mcp.json) for Junie autonomous runs.

plugins/sulcus-junie · v1.1.0
sulcus connect junie

Antigravity Harness

Native Harness

Clean single-agent workstation hooks: sub-15ms PreInvocation recall, PostToolUse file and CLI ledger recording, Stop turn ingestion, Dynamic Skills VMMU stubs, and Ganymede pid_map namespace resolution.

plugins/sulcus-agy · v1.3.0
sulcus connect agy

Claude Code

Autonomous CLI

UserPromptSubmit recall, PostToolUse mutation snapshots, Stop System 1 VCR distillation, and zero-secret .mcp.json and ~/.claude.json wiring.

plugins/sulcus-claude-code · v1.1.0
sulcus connect claude-code

Gemini CLI

Autonomous CLI

Native ~/.gemini/settings.json and workspace .gemini/settings.json MCP proxy registration plus pure-Rust lifecycle hooks.

~/.gemini/settings.json · v3.1.0
sulcus connect gemini

Cursor Editor

Editor Harness

Zero-secret MCP proxy configuration, workspace rules, AST v2 symbol lookup, and repository-scoped recall for Cursor Agent and Composer.

plugins/sulcus-cursor · v1.0.0
sulcus connect cursor

Windsurf Editor

Editor Harness

Cascade memory persistence, cross-repo linked namespace awareness, and reactive trigger tools wired through mcp_config.json.

plugins/sulcus-windsurf · v1.0.0
sulcus connect windsurf

Codex CLI

Autonomous CLI

Automatic .codex/mcp.json proxy registration, session context recall, and Caveman CLI output compaction.

plugins/sulcus-codex · v1.0.0
sulcus connect codex

OpenCode CLI

Autonomous CLI

Native opencode.json local MCP array integration (["sulcus", "mcp-proxy"]) plus pure-Rust lifecycle hooks.

plugins/sulcus-opencode · v1.0.0
sulcus connect opencode

Zed Editor

Editor Harness

Low-latency Rust-to-Rust context_servers registration for Zed Assistant panels with local Tree-sitter AST v2.

plugins/sulcus-zed · v1.0.0
sulcus connect zed

Neovim Plugin

Lua Plugin

MIT open-source Lua plugin providing buffer territory heartbeats, visual-selection memory capture, and Telescope hybrid recall.

plugins/sulcus-neovim · v1.0.0
require("sulcus").setup() in init.lua

Cline Harness

IDE Agent

Automated cline_mcp_settings.json registration for persistent task memory, procedural recipe recall, and Activity Ledger safety.

plugins/sulcus-cline · v1.0.0
sulcus connect cline

Continue Extension

IDE Agent

Open-source IDE assistant integration across VS Code and JetBrains via Continue Model Context Protocol.

plugins/sulcus-continue · v1.0.0
Add sulcus mcp-proxy to .continue/mcpServers/sulcus.json

Aider Wrapper

Terminal Agent

Pre-commit context assembly and post-commit architectural capture around Aider terminal coding sessions.

plugins/sulcus-aider · v1.0.0
sulcus-aider wrapper script

Hermes Adapter

Client Hook

Automated auto_recall and auto_capture lifecycle adapter honoring ~/.config/sulcus/sulcus.ini settings.

plugins/sulcus-hermes · v0.2.0
Install plugins/sulcus-hermes client hook

ChatGPT Connector

Cloud Action

OAuth 2.0 OIDC protected OpenAPI 3.1 Action and Remote MCP connector for ChatGPT Enterprise and Team workspaces.

plugins/sulcus-chatgpt · v0.2.0
Connect https://api.sulcus.ca/openapi.json or /mcp OAuth

Shared Workstation Identity

All workstation plugins compute the same canonical X-Sulcus-Machine-Id hardware UUIDv5 and read ~/.config/sulcus/sulcus.ini. Running VS Code, RubyMine with Junie, Antigravity, and Claude Code concurrently on the same laptop consumes a single named workstation seat.
Programmatic Clients

Official Language SDKs

Distributed from the official Git monorepo (github.com/digitalforgeca/sulcus) and signed Cloudflare R2 release channels.

Sulcus Binary

Native Engine

Single native Rust binary compiling workstation CLI (login, connect, hook, mcp-proxy, search, daemon, index, symbol, skill, model, train, learn, doctor), embedded PostgreSQL 17, and CPU embeddings.

curl -fsSL https://sulcus.ca/install.sh | bash
sulcus (v3.1.0)Source

Python SDK

Official Client

Sync and async Python client with Golden Index helpers, hybrid search, reactive triggers, System 1 VCR signals, and zero mandatory third-party dependencies.

pip install "git+https://github.com/digitalforgeca/sulcus.git#subdirectory=sdks/python"
sulcus (v3.1.0)Source

TypeScript SDK

Official Client

Zero-dependency TypeScript and Node.js SDK with full types for memories, triggers, Agent Bus, Linked Namespaces, and token-budgeted context assembly.

git clone https://github.com/digitalforgeca/sulcus.git && cd sulcus/sdks/node && npm run build
sulcus (v3.1.0)Source

LangChain Adapter

Framework

SulcusCallbackHandler and SulcusMemory adapters for LangChain chains and LangGraph stateful agent workflows.

pip install "git+https://github.com/digitalforgeca/sulcus.git#subdirectory=integrations/langchain"
sulcus-langchain (v0.1.0)Source

CrewAI Adapter

Framework

SulcusCrewHooks and SulcusContextTool enabling shared multi-agent crew recall with Two-Gate Namespace ACL governance.

pip install "git+https://github.com/digitalforgeca/sulcus.git#subdirectory=integrations/crewai"
sulcus-crewai (v0.1.0)Source

Deep Agents

Framework

Thermodynamic memory middleware replacing static markdown scratchpads in long-horizon autonomous Deep Agents.

pip install "git+https://github.com/digitalforgeca/sulcus.git#subdirectory=integrations/deepagents"
sulcus-deepagents (v0.1.0)Source

Vercel Middleware

Framework

LanguageModelV3Middleware for wrapLanguageModel providing automatic pre-turn recall and post-turn System 1 VCR distillation.

git clone https://github.com/digitalforgeca/sulcus.git && cd sulcus/integrations/vercel-ai && npm run build
sulcus-vercel-ai (v0.1.0)Source

LlamaIndex Store

Framework

Thermodynamic chat store and graph-resonant retriever integration for LlamaIndex pipelines.

pip install "git+https://github.com/digitalforgeca/sulcus.git#subdirectory=integrations/llamaindex"
sulcus-llamaindex (v0.1.0)Source

Raw Protocol Schemas

Every SDK and harness plugin calls the exact HTTP REST and MCP JSON-RPC endpoints documented in our API Reference.

API
Engineering Dispatches

Architecture Release Notes

Receive technical deep dives on thermodynamic context engineering, System 1 VCR cartridge updates, SulcusBench evaluations, and signed v3.1 engine releases directly from Digital Forge Studios.