The Universal AI Operating System for Senior Developers

One setup. Every AI tool. Everywhere.

📑 Table of Contents

• What is SEOSONA OS?
• Key Features
• Tool Coverage
• Installation
• Usage
• Repository Structure
• Skill Framework Library
• How It Works — Under the Hood
• Community & Standards
• Changelog
• License

🧠 What is SEOSONA OS?

SEOSONA OS is a Universal AI Operating System — a self-installing, self-scanning environment that automatically detects every AI coding tool installed on your machine and injects a unified Master Intelligence Layer (your SOUL.md) into each one.

No more copy-pasting system prompts. No more configuring each tool separately. No more AI that doesn't know who you are, how you work, or what rules you follow.

Run one command. Every AI on your machine becomes SEOSONA.

"You are not a simple chatbot; you are an end-to-end operational agent." — SOUL.md, Prime Directive

✨ Key Features

| Feature | Description | |---|---| | 🔍 Omni-Scanner | Auto-detects every installed IDE and CLI tool on your machine | | 🧬 DNA Injection | Injects full SOUL.md content (not just a pointer) directly into each tool | | 🌍 Cross-Platform | Works on Windows (PowerShell), macOS and Linux (Node.js CLI) | | 🔒 Zero Hardcodes | All paths are computed at runtime — portable across any machine | | ⚡ 1-Click Setup | Run npm install -g seosona-cli | | 🧩 Modular Skills | 20+ skill frameworks covering SEO, Frontend, Security, Testing, and more | | 🧠 MemPalace Architecture | Structured spatial memory system for persistent AI context | | 🚨 OmniClaw Protocol | Zero-tolerance ruleset preventing AI from bypassing workflows |

🛠️ Tool Coverage

SEOSONA OS automatically detects and configures the following tools:

🖥️ IDEs

| Tool | Injection Method | Config Target | |---|---|---| | Cursor | settings.json | cursor.general.rules | | Windsurf | settings.json | windsurf.general.rules | | PearAI | settings.json | pearai.general.rules | | Trae | settings.json | trae.general.rules | | VSCode | settings.json | github.copilot.chat.*, cline.customInstructions, roo-cline.customInstructions | | VSCodium | settings.json | Same as VSCode |

⌨️ CLI Tools

| Tool | Injection Method | Config Target | |---|---|---| | Claude CLI | PowerShell wrapper function | --system-prompt flag | | Aider | ~/.aider.conf.yml | system-prompt field | | OpenInterpreter | config.yaml | system_message field | | Codex | ~/.codex/AGENTS.md | Prepended content | | SecureCoder | ~/.securecoder/AGENTS.md | Prepended content | | Continue.dev | ~/.continue/config.json | systemMessage field |

🤖 Environment Variables (Antigravity & Custom CLIs)

| Variable | Purpose | |---|---| | ANTIGRAVITY_SYSTEM_PROMPT | Injects SOUL into Antigravity IDE | | SEOSONA_MASTER_PROMPT | Universal variable for any custom tool | | AIDER_SYSTEM_PROMPT | Backup injection for Aider |

📁 Project-Local Files (seosona-init)

When you run seosona init in a project folder, it generates only the files relevant to your installed tools:

.cursorrules              # Cursor IDE
.windsurfrules            # Windsurf IDE
.clauderules              # Claude CLI
.clinerules               # Cline extension
.roomodes                 # Roo Code extension
.aider.conf.yml           # Aider CLI
.antigravityrules         # Antigravity IDE
.codexrules               # OpenAI Codex
.securecoderrules         # SecureCoder
.openinterpreter          # OpenInterpreter
.github/copilot-instructions.md   # GitHub Copilot Enterprise
.cody/prompt              # Sourcegraph Cody
.bolt/prompt              # Bolt.new
.lovable/prompt           # Lovable.dev

Smart Detection: Files are only created for tools that are actually installed on your machine. No phantom files for tools you don't have.

🚀 Installation

Method 1: NPM (Recommended — Cross-Platform)

# Install the CLI globally via npm
npm install -g seosona-cli

# Run the global setup wizard
seosona setup

Method 2: Manual Clone & Run (Developers)

# Clone the repository
git clone https://github.com/LongLeo287/SEOSONA-OS.git
cd SEOSONA-OS/cli

# Install globally from local source
npm install -g .

# Run setup
seosona setup

📖 Usage

For Non-Technical Users (Zero-Touch)

Just run setup once. SEOSONA OS handles everything automatically. Every IDE you open from that point on will operate under SEOSONA rules.

seosona setup

For Developers (Expert Mode)

# Global machine setup (run once per machine)
seosona setup

# Bind a project (run once per project folder)
cd /path/to/your/project
seosona init

# Check what was injected
seosona setup    # Re-run anytime to verify state

🏗️ Repository Structure

SEOSONA OS/
│
├── 📂 1_CORE/                        # The Brain — Core intelligence layer
│   ├── 🧠 SOUL.md                    # Master system prompt (9,400+ chars)
│   └── 📂 rules/                     # Security, API, and interface rules
│       ├── security_regex_rules.md
│       ├── dependency_audit_rules.md
│       └── interface_contract_validation.md
│
├── 📂 2_KNOWLEDGE/                   # The Skills — Modular capability library
│   ├── 📋 SKILLS_ROUTER.md           # Index of all registered skills
│   ├── 📂 sops/                      # Standard Operating Procedures
│   │   ├── mempalace_sop.md          # Spatial memory architecture
│   │   ├── context_cleaning_optimization.md
│   │   └── omniclaw_blackboard_protocol.md
│   └── 📂 frameworks/               # Domain-specific skill packs
│       ├── core_system/             # Engineering rules, memory, security
│       ├── seo_marketing/           # SEO, content, landing pages, LinkedIn
│       ├── frontend_engineering/    # UI/UX, Hoversource, design tokens
│       └── testing_automation/      # Playwright, test workflows
│
├── 📂 3_MEMORY/                      # The Memory — Persistent session storage
│   ├── specs/                        # Architecture docs & technical specs
│   ├── logs/                         # Chronological session logs
│   ├── errors/                       # Error reports & debug records
│   └── ingestion_zone/              # Staging area for new knowledge
│

├── 📂 cli/                           # Node.js CLI package
│   ├── bin/seosona.js               # CLI entry point
│   ├── src/
│   │   ├── globalSetup.js           # Cross-platform Global Scanner
│   │   ├── localInit.js             # Cross-platform Local Scanner
│   │   └── utils.js                 # Shared utilities
│   ├── scripts/bundle-soul.js       # Pre-build: bundles SOUL.md into package
│   └── package.json                 # npm package definition
│
├── 📂 repos/                         # Tracked reference repositories

└── 📖 README.md                      # You are here

🧩 Skill Framework Library

SEOSONA OS ships with 20+ modular skills across 5 domains:

🔧 Core System

• Harness Engineering Machine — End-to-end operational agent framework
• OmniClaw Blackboard Protocol — Multi-agent coordination & CEO Rule
• MemPalace Architecture — Spatial verbatim memory layout
• Post-Session Learning — Auto-assimilation of new knowledge
• Security Scanning — Pre-commit regex auditing & dependency checks

🎨 Frontend Engineering

• UI/UX Pro Max Typography — Design token standards
• Web Interface Compliance — Accessibility & performance gates
• Tailwind Motion Design — Animation system rules
• Hoversource Integration — Component integration workflows

📈 SEO & Marketing

• SEO/AEO Best Practices — E-E-A-T, schema, Core Web Vitals
• Content Creator — Brand voice, social optimization
• Landing Page Generator — Conversion patterns & scaffolding
• LinkedIn Authority Builder — B2B content framework
• SEO Migration Assistant — Technical migration SOPs

🧪 Testing & Automation

• Playwright Suite — E2E testing workflows & CLI reference
• Swarms Auto-Research Loop — Autonomous research agent patterns

🤖 Ingested Intelligence

• Agentic OS Architecture — Multi-agent system design
• LightRAG Graph Mapping — Entity-relationship standards
• Context Cleaning Optimization — Token efficiency rules
• Scrapling/Crawling DOM — Web scraping best practices

⚙️ How It Works — Under the Hood

The Universal Anchor

SEOSONA OS creates a filesystem junction at ~/.seosona pointing to wherever the actual SEOSONA OS directory lives. This means:

• All tools read from ~/.seosona regardless of where you stored the files
• Move the folder anywhere, re-run seosona setup, the anchor updates automatically
• Zero hardcoded paths anywhere in the system

The Injection Chain

seosona setup (run once)
    │
    ├── Reads SOUL.md (9,400+ chars of pure intelligence)
    │
    ├── [Global Level] Writes to IDE settings.json files
    │       Cursor → settings.json → cursor.general.rules
    │       VSCode → settings.json → copilot/cline/roo keys
    │       Aider  → ~/.aider.conf.yml → system-prompt
    │       ...
    │
    ├── [OS Level] Sets Windows Environment Variables
    │       ANTIGRAVITY_SYSTEM_PROMPT = <full SOUL.md content>
    │       SEOSONA_MASTER_PROMPT     = <full SOUL.md content>
    │
    └── [Shell Level] Injects PowerShell profile wrappers
            seosona-init → available globally in any terminal
            seosona-claude → wraps Claude CLI with --system-prompt
            git init → auto-calls seosona-init on new projects

seosona-init (run per project)
    │
    ├── Detects installed tools on THIS machine
    └── Drops ONLY relevant rule files into the project root
            No phantom files for tools you don't have

The SOUL.md — Master Intelligence

The SOUL.md file contains the full cognitive blueprint of SEOSONA OS:

• Prime Directive — The Evolution Mandate
• OmniClaw Protocol — Zero-tolerance bypass rules
• Enforced SOPs — Engineering standards, security rules, memory patterns
• Master Flow — The 5-phase execution model for every task
• Sub-persona Activation — Context-aware behavior switching

🤝 Community & Standards

We welcome contributions from the community! To maintain a safe and productive environment, please review our community standards before participating:

• Contributing Guidelines: Instructions on how to submit bug reports, feature requests, and Pull Requests (including adding new skills).
• Code of Conduct: Our pledge to maintain a welcoming, inclusive, and harassment-free community.
• Security Policy: Instructions for reporting security vulnerabilities safely.

📋 Changelog

Please see our dedicated CHANGELOG.md file for a detailed history of all updates and releases.

📜 License

MIT License — See LICENSE for details.

Built by SEOSONA. Powered by the Prime Directive.

"Always learning, upgrading, optimizing, automating, developing, improving... from new data, new information, new knowledge. Learn from mistakes to be better."