OSOP Agent Rules

April 14, 2026 · View on GitHub

Part of The Loop. Drop-in .osoplog generation for 18 AI coding platforms.

One install, your AI agent produces structured execution records after every task. Claude Code, Cursor, Codex, Windsurf, Copilot, and 13 more. Start The Loop with one command: ./install.sh

Supported Platforms

Platform	File	Install Method
Cursor	`.cursor/rules/osop-session-logging.mdc`	Auto / Manual
OpenAI Codex	`AGENTS.md`	Auto / Manual
Windsurf	`.windsurf/rules/osop-session-logging.md`	Auto / Manual
Continue.dev	`.continue/rules/osop-session-logging.yaml`	Auto / Manual
Aider	`CONVENTIONS.md`	Auto / Manual
Cline	`.clinerules/osop-session-logging.md`	Auto / Manual
Roo Code	`.roo/rules/osop-session-logging.md`	Auto / Manual
Devin	`playbooks/osop-session-logging.md`	Auto / Manual
Obsidian	`.obsidian/copilot-custom-prompts/osop-session-logging.md`	Auto / Manual
Zed	`.rules` (project root)	Auto / Manual
Sourcegraph Amp	`AGENT.md`	Auto / Manual
Trae	`project_rules.md`	Auto / Manual
PearAI	Custom command config	Manual
Sweep AI	`.claude/skills/osop-session-logging/SKILL.md`	Auto / Manual
SWE-agent	`.swe-agent/osop-config.yaml`	Manual
Claude Code	`CLAUDE.md`	Plugin
OpenClaw	ClawHub skill	`clawhub install osop`
GitHub Copilot	MCP server	osop-mcp

Quick Install

Auto-detect (recommended)

git clone https://github.com/Archie0125/osop-agent-rules.git
cd osop-agent-rules
./install.sh

The installer detects which AI tools you have and installs the right files.

Install for all platforms

./install.sh --all

Install for specific platforms

./install.sh --cursor --aider --codex

List detected platforms

./install.sh --list

Manual Install

Copy the file for your platform into your project:

Cursor

mkdir -p .cursor/rules
cp cursor/osop-session-logging.mdc .cursor/rules/

OpenAI Codex

cp codex/AGENTS.md .

Windsurf

mkdir -p .windsurf/rules
cp windsurf/osop-session-logging.md .windsurf/rules/

Continue.dev

mkdir -p .continue/rules
cp continue-dev/osop-rules.yaml .continue/rules/osop-session-logging.yaml

Aider

cp aider/CONVENTIONS.md .

Or add to existing .aider.conf.yml:

read:
  - path/to/osop-agent-rules/aider/CONVENTIONS.md

Cline

mkdir -p .clinerules
cp cline/osop-session-logging.md .clinerules/

Roo Code

mkdir -p .roo/rules
cp roo-code/osop-session-logging.md .roo/rules/

Devin

mkdir -p playbooks
cp devin/osop-session-logging.md playbooks/

Claude Code

Use the native plugin:

claude /install-plugin https://github.com/Archie0125/osop-skill

OpenClaw

clawhub install osop
clawhub install osop-log
clawhub install osop-report
clawhub install osop-review
clawhub install osop-optimize

Obsidian

mkdir -p .obsidian/copilot-custom-prompts
cp obsidian/osop-session-logging.md .obsidian/copilot-custom-prompts/

Zed

cp zed/osop-session-logging.md .rules

Or open Zed's Rules Library (Cmd-Alt-L) and paste the content.

Sourcegraph Amp

cp amp/AGENT.md .

Trae

cp trae/project_rules.md .

SWE-agent

mkdir -p .swe-agent
cp swe-agent/osop-config.yaml .swe-agent/

Reference via --config .swe-agent/osop-config.yaml.

GitHub Copilot

Use the MCP server — see copilot/README.md.

What You Get

After your AI agent completes a multi-step task, it produces:

sessions/2026-04-01-fix-auth-bug.osop — workflow definition

osop_version: "1.0"
id: session-fix-auth-bug
name: "Fix Authentication Bug"
nodes:
  - id: explore
    type: agent
    subtype: explore
    name: "Search Auth Code"
  - id: fix
    type: agent
    name: "Write Fix"
edges:
  - from: explore
    to: fix

sessions/2026-04-01-fix-auth-bug.osoplog.yaml — execution record

osoplog_version: "1.0"
status: COMPLETED
duration_ms: 930000
node_records:
  - node_id: explore
    status: COMPLETED
    tools_used:
      - { tool: Grep, calls: 5 }
      - { tool: Read, calls: 4 }

View them at https://osop-editor.vercel.app or generate HTML reports.

Structure

osop-agent-rules/
├── CORE-INSTRUCTIONS.md     # Platform-agnostic source content
├── install.sh               # Universal installer
├── cursor/                  # Cursor .mdc rule
├── codex/                   # OpenAI Codex AGENTS.md
├── windsurf/                # Windsurf rule
├── continue-dev/            # Continue.dev YAML rule
├── aider/                   # Aider CONVENTIONS.md
├── cline/                   # Cline rule
├── roo-code/                # Roo Code rule
├── devin/                   # Devin playbook
├── obsidian/                # Obsidian Copilot prompt
├── zed/                     # Zed editor rules
├── amp/                     # Sourcegraph Amp AGENT.md
├── trae/                    # Trae project rules
├── pearai/                  # PearAI custom command
├── sweep/                   # Sweep AI SKILL.md
├── swe-agent/               # SWE-agent YAML config
└── copilot/                 # Copilot MCP integration guide

License

Apache-2.0