@ttunahank/mos-cli
v0.5.0
Published
Marketing Operating System - CLI for multi-agent marketing campaigns with Google Ads & Shopping intelligence
Downloads
645
Maintainers
Readme
MOS - Marketing Operating System
AI-Powered Marketing Automation for Modern Brands
🚀 What is MOS?
MOS (Marketing Operating System) is a next-generation marketing automation platform that uses specialized AI agents to create, orchestrate, and optimize marketing campaigns across multiple channels.
Unlike traditional marketing tools that focus on a single channel or function, MOS provides a complete operating system for your marketing operations - from strategy to execution to learning.
✨ Key Differentiators
🎯 Platform-Native Content (Not Generic)
Every platform is a different universe. MOS has specialized agents for:
- LinkedIn (B2B, thought leadership)
- Instagram (visual storytelling, Reels)
- Meta Ads (Facebook + Instagram advertising)
- Email (sequences, automation)
- X/Twitter (viral threads, engagement)
Result: Content optimized for each platform's algorithm, audience, and format.
🧠 Learning System (Gets Better Over Time)
MOS learns from every campaign:
- What content performs well
- What messaging resonates
- What timing works best
- What to avoid repeating
Result: Each campaign is better than the last.
⚖️ Ethics Spectrum (Adapts to Your Stage)
Marketing tactics change as you grow:
- First 100 customers: Guerrilla tactics, aggressive growth
- 1000+ users: Sustainable, community-focused
- Established: White hat, brand reputation
Result: Appropriate tactics for your current stage.
🎭 Multi-Agent Collaboration (Campaign War Room)
All specialist agents work together on campaigns:
- Master Orchestrator coordinates
- Platform Specialists create content
- Brand Voice Guardian ensures consistency
Result: Coordinated multi-channel campaigns, not siloed efforts.
📁 Project Structure
marketing-team/
├── .mos/ # MOS system (agents, workflows, tasks)
├── brand/ # Your brand identity & learnings
├── campaigns/ # Campaign outputs
└── docs/ # Research, notes, brainstormingSee .mos/README.md for detailed system architecture.
📦 Installation
Requirements
- Node.js: 20+ LTS (required)
- NPM: 10+ (included with Node.js)
- Terminal: macOS Terminal, Windows PowerShell, or Linux shell
Quick Start
# Install MOS in your project
npx @mos/cli@latest install
# Follow interactive prompts to configure your brandInstallation Steps
Create Project Directory
mkdir my-brand-project cd my-brand-projectRun Installation
npx @mos/cli@latest installConfigure Brand
- Answer interactive prompts (brand name, language, etc.)
- Select IDE(s) for integration (Claude Code, Gemini CLI, etc.)
Start Creating Campaigns
# Claude Code: /campaign-brief # Gemini CLI: @campaign-brief # Manual CLI: mos campaign-brief
For detailed architecture and development setup, see Architecture Document.
🎯 Current Status
Version: 0.1.0
Completed Milestones:
- ✅ Brainstorming Session (155+ ideas, 4 techniques)
- ✅ BMAD Technical Research (architecture analysis)
- ✅ MOS Core Structure (folders, config, workflow engine)
- ✅ Brand DNA Schema
- ✅ Master Orchestrator Agent (campaign coordination)
- ✅ LinkedIn Guru Agent (B2B thought leadership)
- ✅ Instagram Master Agent (visual storytelling)
- ✅ Email Maestro Agent (sequences, automation, copywriting)
- ✅ Meta Ads Specialist Agent (ANDROMEDA-optimized, Oct 2025)
- ✅ X Strategist Agent (viral threads, 3:1 reply ratio, algorithm-optimized)
- ✅ Brand DNA Discovery Agent (onboarding with web scraping)
- ✅ Algorithm Update Tracking System (quarterly monitoring, 5 platforms)
- ✅ Campaign Brief Workflow (campaign planning)
- ✅ Brand DNA Setup Workflow (interactive onboarding)
- ✅ Platform Asset Workflow (platform-specific content generation)
Active Development:
- 🔨 Party Mode / Campaign War Room
- 🔨 Slash command integration
- 🔨 Production testing & refinement
💡 Use Cases
Solo Founder (Zeynep - SaaS)
Challenge: Limited marketing knowledge, no budget MOS Solution:
- Discovery Agent helps define brand voice
- Platform Discovery Agent suggests where to be active
- Guerrilla Marketing Agent provides survival tactics
- First 100 Customers playbook
E-commerce Owner (Mehmet - Physical Products)
Challenge: Multiple marketplaces, need reviews, SEO critical MOS Solution:
- Marketplace Orchestrator (Amazon, Walmart, Trendyol sync)
- Influencer Campaign Coordinator (bulk micro-influencer outreach)
- Hero Product Selection (focus marketing budget)
- Review Bootstrapping (ethical early review generation)
Enterprise CMO (Ayşe - B2B SaaS)
Challenge: Coordinate 15-person team, ensure consistency, ROI reporting MOS Solution:
- Team Orchestration Mode (multi-user coordination)
- Brand Voice Guardian (consistency across team)
- CMO Dashboard (unified metrics, ROI tracking)
- Quarterly Planner (90-day campaign roadmaps)
🛠️ Tech Stack
- AI Model: Claude (Sonnet 4.5)
- Storage: File-based (Markdown, YAML, XML)
- Version Control: Git-friendly
- Environment: Claude Code
- Architecture: Agent-based, workflow-driven
📚 Documentation
.mos/README.md- System architecturedocs/brainstorming-session-results-2025-11-22.md- Full brainstorming sessiondocs/bmad-technical-research-2025-11-22.md- Technical architecture research
🗺️ Roadmap
Phase 1: MVP (Weeks 1-2) ⏳
- Master Orchestrator Agent
- LinkedIn Guru Agent
- Campaign Brief Workflow
- Platform Asset Creation
Phase 2: Core Agents (Weeks 3-4)
- Instagram Master Agent
- Meta Ads Specialist Agent
- Email Maestro Agent
- X Strategist Agent
Phase 3: Campaign System (Weeks 5-6)
- Campaign War Room (Party Mode)
- Brand Voice Guardian
- Multi-agent coordination
- Campaign tracking
Phase 4: Beta Testing (Weeks 7-8)
- Real user testing (3 personas)
- Feedback & iteration
- Performance optimization
- Documentation
Phase 5: Launch Prep (Weeks 9-12)
- Packaging & distribution
- Marketing website
- Demo videos
- Launch campaign (meta! 🤯)
🎬 Vision
Short-term: Help startups and e-commerce brands punch above their weight in marketing.
Long-term: The operating system for all marketing teams - from solo founders to Fortune 500 CMOs.
Moonshot: Self-learning marketing brain that predicts trends, proactively suggests campaigns, and continuously optimizes based on market signals.
👨💻 Creator
Tuna
- Product visionary
- Marketing strategist
- AI-powered automation enthusiast
Started: November 22, 2025 Location: Istanbul, Turkey 🇹🇷
📬 Contact
Questions? Ideas? Want to collaborate?
- Project: Marketing Operating System (MOS)
- Status: Private Development (considering open-source in future)
Built with ❤️ and 🤖 AI
MOS - Where Marketing Meets Methodology. ✨
