Imported from danieljustus/symaira-eraseme (AGENTS.md). Install upstream with npx skills add danieljustus/symaira-eraseme. Copyright stays with the author.

AI Agent Integration Guide

Current product contract

PB-2026-09-09 keeps EraseMe an independent specialized product. Browse and Operate become optional Brain modules; the credential service remains independently usable. None becomes a mandatory Brain gateway/context dependency for EraseMe. Existing command/API, privacy, evidence and approval contracts remain unchanged until explicit tested migrations. Do not couple privacy workflows to the presence of Brain's GUI.

Symaira EraseMe supports all major AI coding agents through standardized skill formats and adapter files.

Ecosystem Guidance

• Before changing cross-tool integrations, shared conventions, or product boundaries, read PB-2026-09-09; it is available in standalone checkouts.
• Keep the standalone-first contract: this repo must install, test, and run without any other Symaira tool installed.

Quick Reference

Cross-Agent Compatibility

Five agents support the SKILL.md standard natively:

• Hermes, GitHub Copilot CLI, Codex CLI, Cursor, Windsurf

These agents auto-discover from .agents/skills/ (already configured in this repo).

Skill Bundle Contents

The skill bundle (skills/SKILL.md + sub-skills) includes:

• SKILL.md — Main skill definition with CLI command reference
• workflow-removal-cycle.md — Complete removal lifecycle orchestration guide
• setup-identity.md — Identity vault setup
• plan-removal-campaign.md — Campaign planning
• send-removal-batch.md — Sending removal requests
• triage-broker-replies.md — Daily inbox triage workflow
• handle-action-required.md — Handling verifications and rejections
• daily-tick.md — Running the tick engine
• re-scan-quarterly.md — Quarterly re-scan workflow

The workflow-removal-cycle.md template ties all sub-skills together into a repeatable cycle: plan → execute → wait → poll → classify → respond → tick → re-scan. It includes a decision matrix for when to use each command and error handling guidance.

Agent-Specific Setup

Claude Code

Format: SKILL.md
Path: .claude/skills/symaira-eraseme/
Status: ✅ Already configured (symlink exists)

cd /path/to/symaira-eraseme
# Already configured:
ls -la .claude/skills/
# symeraseme -> ../../skills/

See examples/claude-code/ for details.

OpenClaw

Format: YAML
Path: ~/.config/openclaw/skills/symeraseme.yaml
Status: Manual install required

# Copy YAML skill definition
cp examples/openclaw/symeraseme.yaml ~/.config/openclaw/skills/
openclaw skill load symeraseme

See examples/openclaw/ for details.

Hermes

Format: SKILL.md
Path: ~/.hermes/skills/privacy-tools/symaira-eraseme/
Status: Manual install required

hermes skills install https://raw.githubusercontent.com/danieljustus/Symaira-EraseMe/main/skills/SKILL.md

Or manually:

mkdir -p ~/.hermes/skills/privacy-tools/symaira-eraseme
cp skills/SKILL.md ~/.hermes/skills/privacy-tools/symaira-eraseme/

See examples/hermes/ for details.

GitHub Copilot CLI

Format: SKILL.md
Path: .agents/skills/ or ~/.copilot/skills/
Status: ✅ Auto-discovered from .agents/skills/

# Already configured in this repo:
ls -la .agents/skills/
# symaira-eraseme -> ../../skills/

Verify:

copilot /skills reload
copilot /skills info symaira-eraseme

Codex CLI

Format: SKILL.md
Path: .agents/skills/ or ~/.codex/skills/
Status: ✅ Auto-discovered from .agents/skills/

# Already configured in this repo
codex /skills reload
codex /skills info symaira-eraseme

See examples/codex/ for optional metadata file.

Cursor

Format: SKILL.md (skills) + .mdc (rules)
Path: .cursor/skills/ or .agents/skills/
Status: ✅ Auto-discovered from .agents/skills/

Optional: Add rules for enhanced context:

mkdir -p .cursor/rules
cp examples/cursor/symaira-eraseme.mdc .cursor/rules/

See examples/cursor/ for details.

Windsurf

Format: SKILL.md (skills) + .md (rules)
Path: .windsurf/skills/ or .agents/skills/
Status: ✅ Auto-discovered from .agents/skills/

Optional: Add rules and workflows:

mkdir -p .windsurf/rules .windsurf/workflows
cp examples/windsurf/symaira-eraseme.md .windsurf/rules/
cp examples/windsurf/remove-data.md .windsurf/workflows/

See examples/windsurf/ for details.

Continue

Format: .md rules
Path: .continue/rules/
Status: Manual setup required

mkdir -p .continue/rules
cp examples/continue/symaira-eraseme.md .continue/rules/

Optional: Create .continuerc.json for project config.

See examples/continue/ for details.

Cline

Format: .md rules
Path: .clinerules/
Status: Manual setup required

mkdir -p .clinerules
cp examples/cline/00-symaira-eraseme.md .clinerules/

Cline also auto-detects AGENTS.md, .cursorrules, and .windsurfrules.

See examples/cline/ for details.

Aider

Format: CONVENTIONS.md
Path: Project root or ~/.config/aider/
Status: Manual setup required

cp examples/aider/CONVENTIONS.md ./CONVENTIONS.md

Add to .aider.conf.yml:

read:
  - CONVENTIONS.md

See examples/aider/ for details.

Universal Setup Script

For convenience, a setup script is provided:

# Setup all supported agents
./scripts/setup-agents.sh

# Setup specific agent
./scripts/setup-agents.sh --agent cursor
./scripts/setup-agents.sh --agent cline

Environment Variables

All agents require these environment variables:

# Required for LLM triage
export ANTHROPIC_API_KEY="sk-ant-..."

# Optional: Data directory
export SYMERASEME_DATA_DIR="$HOME/.symeraseme"

# Optional: CAPTCHA solving
export CAPSOLVER_API_KEY="CAP-..."

Testing Integration

Verify your agent can access the skill:

1. SKILL.md agents (Hermes, Copilot, Codex, Cursor, Windsurf):

   # Ask your agent:
   "What skills are available?"
   "Help me remove my data from data brokers"

2. Rule-based agents (Continue, Cline, Aider):

   # The agent should reference Symaira EraseMe when relevant
   "I want to exercise my GDPR rights"
   "Help me opt out of data brokers"

Troubleshooting

SKILL.md not discovered

• Ensure the skill directory name matches the name: in frontmatter
• Check that the file is named exactly SKILL.md
• Reload skills: /skills reload (Copilot/Codex) or restart the agent

Commands not found

• Install Symaira EraseMe: brew install danieljustus/tap/symeraseme
• Or download the matching static archive from GitHub Releases
• Verify: symeraseme version

API key errors

• Set ANTHROPIC_API_KEY in your environment
• For Codex/Copilot: ensure env vars are passed to the agent

Contributing

To add support for a new agent:

1. Research the agent's skill/tool format
2. Create an example in examples/<agent-name>/
3. Update this AGENTS.md
4. Update skills/SKILL.md agent list
5. Submit a PR

References

• agentskills.io — Open skill standard
• Claude Code Docs
• Hermes Docs
• Codex Docs
• Cursor Docs
• Windsurf Docs
• Continue Docs
• Cline Docs
• Aider Docs

macOS App (app/SymairaEraseMe/)

• SwiftUI SPM executable (SymairaEraseMe). Build: cd app/SymairaEraseMe && swift build (local builds need DEVELOPER_DIR pointing at a full Xcode installation).
• Depends on the shared symaira-appkit package, pinned exact in Package.swift: SymairaTheme and SymairaToolKit.
• ServerManager launches the bundled or development symeraseme mcp Go binary over HTTP; Homebrew/configured Binary Path is the fallback.
• Migration context: see ../docs/go-test-port-classification.md and TROUBLESHOOTING.md.