Claude Code

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/
• Open Studio in your browser

Manual install

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

cognetivy install claude

Installs SKILL.md and REFERENCE.md into .claude/skills/cognetivy/ in your project.

How it works

Claude Code automatically loads skills from .claude/skills/ in your project. Once the skill is installed, Claude Code knows how to use Cognetivy’s CLI commands without any additional prompt engineering from you.

The skill instructs Claude Code to track runs, log events, and write structured collections - all via the local cognetivy CLI.

MCP connection (alternative)

You can also connect Cognetivy via MCP so tools appear in the chat context. Add this to your Claude MCP config:

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

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

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