🍓 Sonic-Forage Codex Workspace

AI Agent Workspace for the World's First Autonomous DJ Operating System

This repo is purpose-built for OpenAI Codex, Claude Code, Cursor, and other AI coding agents to understand, build, and extend the Sonic-Forage ecosystem.

Quick Start for AI Agents

# Clone this workspace
git clone https://github.com/Sonic-Forage/sonic-forage-codex-workspace.git
cd sonic-forage-codex-workspace

# Read these files IN ORDER:
cat AGENTS.md          # Start here — full project map
cat ARCHITECTURE.md    # How everything connects
cat ECOSYSTEM_MAP.md   # All 14 repos and relationships
cat CONVENTIONS.md     # Coding standards
cat TASKS.md           # What needs building

What Is Sonic-Forage?

The world's first autonomous DJ operating system — built entirely by AI (Hermes Agent by Nous Research), given away for free under MIT license.

• 🎛️ Full DJ mixing engine with AI copilot
• ⌨️ Terminal-native Unicode CDJ interface
• 🍄 Harm reduction resources for festival culture
• 📖 Complete rave culture encyclopedia
• 🌌 Intergalactic 2045 Tour framework
• 🍓 Strawberry mascot, PLUR philosophy

Links

• GitHub Org: https://github.com/Sonic-Forage
• HuggingFace: https://huggingface.co/Sonic-Forage
• Discord: https://discord.gg/57PewGQU2
• Twitter: @M1ND3XPAND3R

For Humans

See PROMPTS.md for useful prompts when working with AI agents on this project.

License

MIT — Fork it. Build it. Play it. 🍓