opscompanion

OpsCompanion Skills

Agent-agnostic skills for OpsCompanion — persistent team memory across agent sessions.

Quick Start

Install the CLI, then install for your agent:

brew install opscompanion/opc/opc

# For Claude Code
opc install --agent claude

# For Codex
opc install --agent codex

opc install handles everything: downloads skills, registers plugins/hooks, and creates a mock config if none exists so you can demo immediately.

Skills

Skill	Trigger	What it does
opscompanion-init	"set up opscompanion"	Configure API key, install hooks
opscompanion-context	"show my org context"	Load org/user/integration context
opscompanion-search	"what did we decide about..."	Search organization knowledge and user memory
opscompanion-observability	"what errors are we seeing?"	Search logs, traces, and run live tails
opscompanion-remember	"remember this decision"	Save decisions for future search

The --agent Contract

Every opc command accepts --agent <name> to normalize behavior across runtimes:

opc --agent claude search "auth migration"   # from Claude Code
opc --agent codex  search "auth migration"   # from Codex
opc search "auth migration"                  # human mode (auto-detect)

The --agent flag controls:

• Which env var to read the session ID from (CLAUDE_SESSION_ID, CODEX_SESSION_ID, etc.)
• Hook configuration format (.claude/settings.local.json vs .codex/hooks.json)
• Session metadata tagging

Skills and hooks generated by opc install automatically include the correct --agent flag.

Mock Mode

Set api_key to mock-key in ~/.config/opscompanion/config.json (or set OPSCOMPANION_MOCK=true) to use realistic mock responses without a backend. opc install does this automatically if no config exists.

Structure

opscompanion-skills/
├── .claude-plugin/
│   └── marketplace.json          # Plugin registry
├── plugins/opscompanion/         # Claude Code plugin
│   ├── .claude-plugin/
│   │   └── plugin.json           # Plugin metadata
│   ├── hooks/
│   │   ├── hooks.json            # Auto-approve opc commands
│   │   └── auto-approve-opc.sh   # Hook script
│   └── skills/
│       ├── opscompanion-init/    # Setup skill
│       ├── opscompanion-context/ # Org context skill
│       ├── opscompanion-search/  # Knowledge search skill
│       ├── opscompanion-observability/ # Logs, traces, and live tail skill
│       └── opscompanion-remember/# Memory save skill
├── agents/skills/                # Codex agent skills
│   ├── opscompanion-init/
│   ├── opscompanion-context/
│   ├── opscompanion-search/
│   ├── opscompanion-observability/
│   └── opscompanion-remember/
└── README.md