Claude Code

Full agent skills + MCP support

Claude Code is a terminal-based coding agent. Cognetivy integrates via agent skills: a SKILL.md file that Claude Code loads automatically from your project’s .claude/skills/ directory. The skill describes when and how to use the Cognetivy CLI so Claude Code can start runs, advance steps, and write collections without extra prompt engineering. You can also connect via MCP for tool-style access.

Prerequisites

Node.js 18+, a project directory (or empty folder) for the .cognetivy/ workspace, and Claude Code installed. No global Cognetivy install is required for the skill path; for MCP, cognetivy must be on your PATH.

Setup

Run the installer from your project directory:

npx cognetivy

Choose Claude Code in the installer. Cognetivy will:

Create a .cognetivy/ workspace in your project
Install the skill into .claude/skills/cognetivy/
Optionally apply a workflow template
Open Studio in your browser

Manual install

If Cognetivy is already installed globally, you can install or update the skill directly:

cognetivy install claude

This writes SKILL.md and REFERENCE.md into .claude/skills/cognetivy/ in your project. Claude Code picks up skills from that directory automatically.

How it works

Claude Code loads skills from .claude/skills/ in your project. The Cognetivy skill instructs Claude Code to use the cognetivy CLI for workflow, run, event, and collection operations. It explains next_step semantics, parallel nodes, traceability (citations, derived_from, reasoning), and schema-first collection writes. No extra prompting is needed for basic run lifecycle and collection writes.

MCP connection (alternative)

You can expose Cognetivy as an MCP server so tools appear in Claude’s context. Add this to your Claude MCP config:

{
  "mcpServers": {
    "cognetivy": {
      "command": "cognetivy",
      "args": ["mcp"]
    }
  }
}

If the workspace is not your project root, add "--workspace", "/path/to/.cognetivy" to args.

Available tools

Claude Code can use all Cognetivy CLI commands through the skill or MCP:

cognetivy workflow get / list / set / versions
cognetivy run start / status / step / complete
cognetivy event append
cognetivy collection get / set / append
cognetivy collection-schema get / set
cognetivy node-result list / get / set

Full reference: CLI reference.

Create your first workflow Full docs on GitHub