Gatewarden Nexus

Tooling

Tools

Everything you need to connect local agents to the nexus platform and manage project memory from the command line.

nexus-mcp

Publishedv0.7.0npm

The mandatory mediation layer between local agent runtimes and the shared backend. All reads and writes to project memory, coordination, and governance workflows flow through the MCP server. The server communicates exclusively with the Nexus HTTP API — no direct database access.

npm: @gwdn/nexus-mcp | Repository: github.com/gwnexus/nexus-mcp (private)

Available tools (38)

Layer 1 — Knowledge Access

kb_searchSearch project knowledge using keyword, semantic, or hybrid mode with relevance ranking
kb_memoryGet curated project context for agent bootstrapping (ADRs, tasks, sessions, letters)
kb_getFetch a single knowledge object in structured, markdown, or summary format
kb_relatedNavigate entity relationships and graph-neighbor entities

Layer 2 — Coordination: Vault Letters

vl_createCreate a new vault letter for agent-to-agent or agent-to-human coordination
vl_replyReply to an existing vault letter with append-only semantics
vl_inboxList vault letters addressed to the calling agent or user
vl_outboxList vault letters sent by the calling agent or user
vl_ackAcknowledge receipt of a vault letter, transitioning it to acknowledged status

Layer 2 — Coordination: Tasks

task_createCreate a new task within a project scope
task_updateUpdate task status, priority, or assignee with automatic audit trail
task_noteAppend a note to a task for progress, blockers, or decisions
task_listList tasks for a project with optional status filtering, ordered by creation date

Layer 2 — Coordination: Sessions

session_createCreate a new work session for a project
session_listList open sessions for a project, ordered by creation date
session_closeClose an open session with optional summary and next entry point
session_appendAppend an entry to an existing session with write isolation
session_deleteDelete empty closed sessions for cleanup

Layer 2 — Coordination: Decisions & Documents

dc_addAdd a comment to an ADR decision (append-only, supports human and agent actors)
dc_listList comments for an ADR decision in chronological order
doc_ingestPush text or markdown content into a project knowledge base
doc_listList ingested documents for a project with optional source filtering

Layer 2 — Coordination: Skills

sk_listList skills for the current tenant with status filtering
sk_getGet full skill content by identifier or UUID
sk_createCreate a new skill in draft status with optional command auto-generation
sk_updateUpdate skill content, metadata, or command settings
sk_activateChange skill status (draft, active, archived)
sk_assignAssign a skill to a specific project scope
sk_unassignRemove a skill assignment from a project
sk_exportExport skill content for local agent bootstrap

Layer 3 — Governance

adr_createCreate a new ADR in draft state with auto-assigned number
adr_submitSubmit an ADR for review (draft to under_review)
adr_decideAccept or reject an ADR with optional rationale and supersession tracking

Layer 4 — Reviews

rv_listList entity reviews filtered by status and entity type
rv_getGet review details including comments and decision history
rv_createRequest a review for any governed entity
rv_decideApprove or reject a pending review with rationale
rv_commentAdd a comment to an active review thread

Quick start

# Run via npx (recommended — no local install needed)
npx @gwdn/nexus-mcp

# Or add to your MCP client configuration:
# OpenCode (opencode.json)
{
  "mcp": {
    "nexus": {
      "type": "local",
      "command": ["npx", "@gwdn/nexus-mcp"],
      "environment": {
        "NEXUS_API_URL": "https://nexus.gatewarden.eu",
        "NEXUS_PRIVATE_TOKEN": "nxs_pat_..."
      }
    }
  }
}

# Claude Code (.claude/mcp.json)
{
  "mcpServers": {
    "nexus": {
      "command": "npx",
      "args": ["@gwdn/nexus-mcp"],
      "env": {
        "NEXUS_API_URL": "https://nexus.gatewarden.eu",
        "NEXUS_PRIVATE_TOKEN": "nxs_pat_..."
      }
    }
  }
}

nexus-cli

Publishedv0.2.0Rust

A fast, native CLI client for the nexus platform. nexus-cli pulls project configuration, skills, and agent bootstrap data from Nexus into customer repositories. It authenticates via the same API token model as the MCP server and communicates exclusively through the Nexus HTTP API.

Repository: github.com/gwnexus/nexus-cli (private)

Commands

Project Setup

nexus initInitialize a Nexus project workspace (scaffold .nexus/, .claude/, MCP configs)
nexus linkBind the current directory to a Nexus project
nexus unlinkRemove project binding from the workspace
nexus deinitRemove all Nexus/AI scaffold files from the workspace

Platform

nexus loginAuthenticate with the Nexus platform (PAT-based)
nexus logoutRemove stored credentials
nexus statusShow auth, project, and workspace status
nexus preflightRun environment readiness checks (git, node, npm, auth, API)

Sync

nexus pullPull skills and configuration from Nexus into the workspace
nexus skills exportExport enabled skills for the linked project as JSON

Configuration

nexus config showDisplay current CLI configuration
nexus config setUpdate a config value (api_url, default_output, no_color, mcp_source)
nexus config pathShow the config file path

Quick start

# Install via oneliner (requires Rust toolchain + GITHUB_TOKEN)
curl -fsSL https://nexus.gatewarden.eu/install.sh | bash

# Or install from source
GITHUB_TOKEN=ghp_... cargo install --git https://github.com/gwnexus/nexus-cli.git nexusctl

# Authenticate
nexus login

# Initialize a customer project
nexus init --project-id <uuid>

# Pull skills and configuration
nexus pull

# Check environment readiness
nexus preflight

Notable flags

--shadowed-aiAdd all AI scaffold files to .gitignore (AGENTS.md, .claude/, .opencode/, opencode.json)
--yes / -yAccept all defaults without interactive prompts (non-interactive mode)
--force / -fOverwrite existing workspace files during init
Back to home