superego

Superego

A metacognitive advisor for AI coding assistants. Monitors conversations, evaluates the assistant's approach, and provides feedback before finishing.

Supported platforms:

• Claude Code - Full support via plugin
• OpenAI Codex CLI - Alpha support via skill (see codex-skill/)
• OpenCode - Alpha support via TypeScript plugin (see opencode-plugin/)

What It Does

When you use Claude Code (or OpenCode) with superego enabled:

1. Session starts - Claude is told superego is active and to take feedback seriously
2. Claude works - You interact normally with Claude
3. Before large edits - Superego evaluates proposed changes in context (Edit/Write over 20 lines)
4. Before Claude finishes - Superego evaluates the full conversation
5. If concerns found - Claude is blocked and shown the feedback
6. Claude continues - Incorporates feedback, may ask you clarifying questions
7. Clean exit - Once addressed (or no concerns), Claude finishes normally

This creates feedback loops where Claude can course-correct both during work and before presenting results.

Quickstart: Claude Code

# 1. Install the plugin
/plugin marketplace add cloud-atlas-ai/superego
/plugin install superego@superego

# 2. Initialize in your project (installs binary if needed)
/superego:init

The /superego:init command detects if the binary is missing and offers to install it via Homebrew or Cargo.

Level Up: Strategic Alignment with Open Horizons

Superego provides metacognitive feedback—but feedback without strategic context is incomplete. For the full power of aligned AI development, combine superego with Open Horizons MCP:

# Add OH MCP marketplace
/plugin marketplace add cloud-atlas-ai/oh-mcp-server
/plugin install oh-mcp@oh-mcp-server

# Configure
/oh-mcp:setup

What you get:

• Superego monitors how Claude works (metacognitive feedback)
• OH MCP connects why Claude works (strategic alignment)
• Every decision traces back to your missions and aims
• Claude logs decisions directly to your strategic framework

Learn more: OH MCP Server | Open Horizons

Slash Commands

Command	Description
/superego:init	Initialize superego for this project (offers binary install if needed)
/superego:status	Check if plugin, binary, and project are configured
/superego:prompt	Manage prompts: list, switch (code/writing), show current
/superego:review	On-demand review of changes (staged, pr, or file)
/superego:enable	Enable superego (offers init if not set up)
/superego:disable	Temporarily disable for current session
/superego:remove	Remove superego from project

Updating

claude plugin marketplace update superego   # Refresh cache
claude plugin update superego@superego      # Update plugin
# Restart Claude Code to apply

Manual binary installation

If you prefer to install the sg binary manually instead of via /superego:init:

# Homebrew (macOS)
brew install cloud-atlas-ai/superego/superego

# Cargo (cross-platform)
cargo install superego

# From source
git clone https://github.com/cloud-atlas-ai/superego.git
cd superego && cargo install --path .

Then run sg init in your project to create .superego/.

Quickstart: OpenCode (Alpha)

OpenCode support is in alpha. It uses a TypeScript plugin that runs entirely within OpenCode—no separate binary needed.

# 1. Download plugin to your project
mkdir -p .opencode/plugin
curl -L -o .opencode/plugin/superego.js \
  https://github.com/cloud-atlas-ai/superego/releases/latest/download/index.js

# 2. Start OpenCode and initialize
opencode
# Ask: "use superego init"

Or install globally:

mkdir -p ~/.config/opencode/plugin
curl -L -o ~/.config/opencode/plugin/superego.js \
  https://github.com/cloud-atlas-ai/superego/releases/latest/download/index.js

See opencode-plugin/README.md for build-from-source instructions and detailed configuration.

Quickstart: OpenAI Codex CLI (Alpha)

Codex support uses a skill that the agent can invoke at decision points.

# 1. Install the skill
mkdir -p ~/.codex/skills/superego
curl -L -o ~/.codex/skills/superego/SKILL.md \
  https://raw.githubusercontent.com/cloud-atlas-ai/superego/main/codex-skill/SKILL.md

# 2. In Codex, ask the agent to set up:
#    "$superego init"

The $superego init command installs the binary, creates .superego/, and adds AGENTS.md guidance automatically.

After setup, the agent calls $superego at decision points to evaluate the conversation.

See codex-skill/ for details.

What You'll See