openads-ai 0.1.0

package/README.md

@@ -0,0 +1,165 @@
+# OpenAds 🎯
+
+```
+  ██████╗ ██████╗ ███████╗███╗   ██╗ █████╗ ██████╗ ███████╗
+  ██╔═══██╗██╔══██╗██╔════╝████╗  ██║██╔══██╗██╔══██╗██╔════╝
+  ██║   ██║██████╔╝█████╗  ██╔██╗ ██║███████║██║  ██║███████╗
+  ██║   ██║██╔═══╝ ██╔══╝  ██║╚██╗██║██╔══██║██║  ██║╚════██║
+  ╚██████╔╝██║     ███████╗██║ ╚████║██║  ██║██████╔╝███████║
+   ╚═════╝ ╚═╝     ╚══════╝╚═╝  ╚═══╝╚═╝  ╚═╝╚═════╝ ╚══════╝
+
+  AI Command Center for Marketers
+```
+
+> **Talk to your ad campaigns in plain English.** Connect your Google Ads and Meta accounts, pick your favorite AI model, and let OpenAds handle the analysis while you focus on strategy.
+
+<p align="center">
+  <img src="https://img.shields.io/badge/Google%20Ads-MCP-4285F4?style=flat-square&logo=google-ads" />
+  <img src="https://img.shields.io/badge/Meta%20Ads-MCP-1877F2?style=flat-square&logo=meta" />
+  <img src="https://img.shields.io/badge/License-MIT-green?style=flat-square" />
+</p>
+
+---
+
+## What is OpenAds?
+
+OpenAds is an **open-source CLI tool** that turns any AI model into a marketing assistant. It's built for performance marketers, media buyers, and growth leads who want to audit campaigns, write ad copy, and build strategies — all from one place.
+
+**No code. No prompt engineering. No spreadsheet exports.**
+
+### Why use it?
+
+| Feature | What it means for you |
+|---|---|
+| 🧠 **Pre-built marketing skills** | The AI already knows Google Ads best practices, Meta creative formats, CRO frameworks, and copywriting rules. You just ask. |
+| 🔌 **Direct platform access** | Connect your Google Ads and Meta accounts. The AI reads your live data — no more copy-pasting reports. |
+| 🤖 **Bring your own model** | Use Google Gemini, OpenAI, Claude, or a local model running on your machine. Your choice. |
+| 🛡️ **Nothing goes live without you** | The AI can read freely, but every write operation (campaign change, budget edit) requires your explicit approval. |
+| ⚡ **Autonomous loops** | Let the AI research competitors, test ad variants, and generate hypotheses overnight. Review in the morning. |
+
+---
+
+## ⚡ Quick Start
+
+### 1. Install
+
+```bash
+npm install -g openads-ai
+```
+
+> **Tip:** If you see a permissions error, prefix with `sudo` or [configure npm for global installs](https://docs.npmjs.com/resolving-eacces-permissions-errors-when-installing-packages-globally).
+
+### 2. Set up (one time)
+
+```bash
+openads setup
+```
+
+The setup wizard walks you through three things:
+- **Pick your AI model** — choose from Google Gemini, OpenAI, Claude, a local model, or any OpenAI-compatible provider
+- **Connect your ad accounts** — Google Ads and/or Meta Ads (both optional)
+- **Describe your business** — so the AI can tailor copy and strategy to your product
+
+### 3. Launch
+
+```bash
+openads
+```
+
+That's it. You'll see a menu with quick actions. Pick one, or just type your question in plain English.
+
+---
+
+## 💡 What can I do with it?
+
+Here are some real examples — just type what you need:
+
+### Ads
+| You type | What happens |
+|---|---|
+| `Audit my Google Ads account and flag budget waste` | Reads your live campaign data, finds underperforming keywords, and tells you where you're losing money. |
+| `My Meta ROAS dropped 30% this week — what changed?` | Pulls your Meta Ads data, compares to the prior period, and pinpoints what shifted. |
+| `Write a 30-second video ad script for TikTok` | Generates a hook → story → CTA script formatted for vertical video with platform-specific timing. |
+
+### Copywriting
+| You type | What happens |
+|---|---|
+| `Write 5 Google Ads headlines for my product` | Generates headlines under 30 characters using your product context, with multiple creative angles. |
+| `Rewrite this landing page to be more persuasive` | Applies PAS/AIDA frameworks, tightens the copy, and fixes benefit vs. feature balance. |
+
+### Strategy
+| You type | What happens |
+|---|---|
+| `Build a go-to-market plan for my Q3 launch` | Produces a structured GTM playbook covering positioning, channels, budget, and timelines. |
+| `Who are my top 3 competitors and what are they saying in their ads?` | Analyzes competitor positioning, identifies messaging gaps, and recommends differentiation angles. |
+| `Research my target audience for a B2B SaaS product` | Builds a customer research brief: pain points, buying triggers, objections, and voice-of-customer language. |
+
+### Optimization
+| You type | What happens |
+|---|---|
+| `My landing page converts at 1.2% — how do I improve it?` | Runs a CRO audit: checks message match, CTA placement, form length, and gives prioritized fixes. |
+| `Set up an A/B test for my signup page headline` | Designs a proper experiment with hypothesis, control vs. variant, sample size, and success criteria. |
+| `Run autoresearch on my ad headlines overnight` | The AI autonomously generates variants, scores them, keeps the best, and reports back in the morning. |
+
+### Post-Click
+| You type | What happens |
+|---|---|
+| `Write a 5-email welcome sequence for new signups` | Creates a full drip sequence: delivery → value → story → objection handling → soft pitch. |
+
+---
+
+## 🔒 Security & Privacy
+
+- **Runs 100% locally.** OpenAds is not a cloud service. Nothing leaves your machine except the API calls you authorize.
+- **No telemetry.** We don't track usage, store data, or phone home.
+- **Your keys stay on disk.** API keys and tokens are saved to `~/.openads/` on your hard drive. They never touch our servers.
+- **Explicit approval for all writes.** The AI previews every campaign change before execution. Nothing goes live without your `Y`.
+
+---
+
+## 🩺 Troubleshooting
+
+Run the built-in diagnostics to check your setup:
+
+```bash
+openads doctor
+```
+
+This verifies your config file, API keys, platform connections (live token checks), and required tools like `uvx`.
+
+---
+
+## 🗺️ Roadmap
+
+- [x] Google Ads integration via MCP
+- [x] Meta Ads integration via MCP
+- [x] Interactive setup wizard with live token verification
+- [x] 12 pre-built skills: Ads, CRO, Copywriting, Analytics, Email, Video, Research, Strategy
+- [x] Autonomous research loops
+- [ ] LinkedIn Ads integration
+- [ ] Pinterest Ads integration
+- [ ] Publish to npm registry
+
+---
+
+## 🤝 Contributing
+
+We want OpenAds to be the standard open-source tool for AI-assisted marketing. You don't need to be a developer to contribute — marketing playbooks and strategy templates are just as valuable as code.
+
+Read [CONTRIBUTING.md](CONTRIBUTING.md) to get started.
+
+---
+
+## Our Principles
+
+1. **Radical Simplicity** — Non-technical marketers must feel at home. No forcing users to learn code, prompt engineering, or API error messages.
+2. **Marketers First** — We design around marketing workflows (audits, copy, analysis), not software concepts.
+3. **Safety by Default** — AI should never spend money or publish campaigns without human approval.
+
+---
+
+## License
+
+MIT.
+
+*Built on [Pi](https://github.com/earendil-works/pi) (MIT). Includes tools derived from [adloop](https://github.com/kLOsk/adloop) (MIT) by kLOsk. Marketing skills inspired by [marketingskills](https://github.com/coreyhaines31/marketingskills) (MIT) by Corey Haines.*

package/dist/cli.js

@@ -0,0 +1,366 @@
+#!/usr/bin/env node
+import { spawn } from 'child_process';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import fs from 'fs';
+import os from 'os';
+import chalk from 'chalk';
+import boxen from 'boxen';
+import gradient from 'gradient-string';
+import ora from 'ora';
+import { runSetup } from './setup.js';
+import { runDoctor } from './doctor.js';
+import enquirer from 'enquirer';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const pkgDir = path.resolve(__dirname, '..');
+// ─── Logo ───────────────────────────────────────────────────────────
+const LOGO = [
+    '  ██████╗ ██████╗ ███████╗███╗   ██╗ █████╗ ██████╗ ███████╗',
+    '  ██╔═══██╗██╔══██╗██╔════╝████╗  ██║██╔══██╗██╔══██╗██╔════╝',
+    '  ██║   ██║██████╔╝█████╗  ██╔██╗ ██║███████║██║  ██║███████╗',
+    '  ██║   ██║██╔═══╝ ██╔══╝  ██║╚██╗██║██╔══██║██║  ██║╚════██║',
+    '  ╚██████╔╝██║     ███████╗██║ ╚████║██║  ██║██████╔╝███████║',
+    '   ╚═════╝ ╚═╝     ╚══════╝╚═╝  ╚═══╝╚═╝  ╚═╝╚═════╝ ╚══════╝',
+].join('\n');
+// Gradient palette: teal → cyan → blue
+const openadsGradient = gradient(['#00d2ff', '#3a7bd5', '#00d2ff']);
+// ─── Config Helpers ─────────────────────────────────────────────────
+const CONFIG_DIR = path.join(os.homedir(), '.openads');
+const CONFIG_PATH = path.join(CONFIG_DIR, 'openads.config.json');
+const DEPRECATED_MODELS = {
+    'google/gemini-1.5-pro': 'google/gemini-2.5-flash',
+    'google/gemini-1.5-pro-latest': 'google/gemini-2.5-flash',
+    'google/gemini-3.5-flash': 'google/gemini-2.5-flash',
+    'openai/gpt-4o': 'openai/gpt-4.1',
+    'openai/gpt-4o-mini': 'openai/gpt-4.1-mini',
+    'anthropic/claude-3-5-sonnet-20241022': 'anthropic/claude-sonnet-4',
+    'anthropic/claude-3-5-haiku-20241022': 'anthropic/claude-haiku-4',
+};
+function loadConfig() {
+    if (!fs.existsSync(CONFIG_PATH))
+        return null;
+    try {
+        return JSON.parse(fs.readFileSync(CONFIG_PATH, 'utf8'));
+    }
+    catch {
+        return null;
+    }
+}
+function resolveModel(provider) {
+    return DEPRECATED_MODELS[provider] || provider;
+}
+// ─── Product Context Injection ──────────────────────────────────────
+// Writes the user's product context as a skill file so the agent always
+// knows what the user sells, who their customer is, etc.
+function injectProductContext(config) {
+    if (!config?.productContext)
+        return null;
+    const contextDir = path.join(CONFIG_DIR, 'context');
+    if (!fs.existsSync(contextDir)) {
+        fs.mkdirSync(contextDir, { recursive: true });
+    }
+    const contextPath = path.join(contextDir, 'my-business.md');
+    const content = `---
+name: my-business
+description: The user's business context — always read this first.
+---
+# My Business
+
+${config.productContext}
+
+Use this context to personalize all recommendations, ad copy, and strategy outputs.
+Always reference this when applying any marketing skill.
+`;
+    fs.writeFileSync(contextPath, content);
+    return contextDir;
+}
+// ─── System Prompt ──────────────────────────────────────────────────
+// Makes the agent behave as "OpenAds" instead of generic Pi.
+function buildSystemPrompt(config) {
+    const parts = [
+        'You are OpenAds, an AI marketing assistant built for digital marketers.',
+        'You specialize in Google Ads, Meta Ads, copywriting, analytics, CRO, and go-to-market strategy.',
+        'Always speak in plain marketing language. Never use developer jargon.',
+        'Address the user as a marketing professional.',
+        'When writing ad copy or recommendations, always reference the user\'s product context first.',
+        'For any write operation (creating campaigns, changing budgets), always preview the change and ask for explicit confirmation before executing.',
+    ];
+    if (config?.productContext) {
+        parts.push(`\nThe user's business: ${config.productContext}`);
+    }
+    if (config?.connectGoogle) {
+        parts.push('Google Ads is connected — you can read live campaign data.');
+    }
+    if (config?.metaToken) {
+        parts.push('Meta Ads is connected — you can read live campaign and creative data.');
+    }
+    return parts.join('\n');
+}
+// ─── API Key Environment Variable Mapping ───────────────────────────
+// Pass API keys via environment variables instead of CLI flags (security).
+function getApiKeyEnvVar(provider) {
+    if (provider.startsWith('google/'))
+        return 'GOOGLE_API_KEY';
+    if (provider.startsWith('openai/'))
+        return 'OPENAI_API_KEY';
+    if (provider.startsWith('anthropic/'))
+        return 'ANTHROPIC_API_KEY';
+    if (provider.startsWith('groq/'))
+        return 'GROQ_API_KEY';
+    // Fallback for OpenRouter, custom providers
+    return 'OPENAI_API_KEY';
+}
+// ─── Skills Browser ─────────────────────────────────────────────────
+function showSkills() {
+    const skillsDir = path.join(pkgDir, 'skills');
+    // Recursively find all .md files
+    function findMarkdown(dir) {
+        const results = [];
+        for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+            const full = path.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                results.push(...findMarkdown(full));
+            }
+            else if (entry.name.endsWith('.md')) {
+                results.push(full);
+            }
+        }
+        return results;
+    }
+    // Extract name and description from frontmatter or first heading
+    function parseMeta(filePath) {
+        const content = fs.readFileSync(filePath, 'utf8');
+        const rel = path.relative(skillsDir, filePath);
+        const parts = rel.split(path.sep);
+        const category = parts.length > 1 ? parts[0] : 'general';
+        // Try YAML frontmatter
+        const fmMatch = content.match(/^---\n([\s\S]*?)\n---/);
+        let name = path.basename(filePath, '.md');
+        let description = '';
+        if (fmMatch) {
+            const nameMatch = fmMatch[1].match(/name:\s*(.+)/);
+            const descMatch = fmMatch[1].match(/description:\s*(.+)/);
+            if (nameMatch)
+                name = nameMatch[1].trim();
+            if (descMatch)
+                description = descMatch[1].trim();
+        }
+        // Fallback: use first heading as name, first paragraph line as description
+        if (!description) {
+            const headingMatch = content.match(/^#\s+(.+)/m);
+            if (headingMatch)
+                name = headingMatch[1].trim();
+            const paraMatch = content.match(/^(?!#|---|\s*$)(.+)/m);
+            if (paraMatch)
+                description = paraMatch[1].trim().slice(0, 80);
+        }
+        return { name, description, category };
+    }
+    const files = findMarkdown(skillsDir);
+    const skills = files.map(parseMeta).sort((a, b) => a.category.localeCompare(b.category));
+    console.log('');
+    console.log(chalk.bold.cyan('  Installed Skills'));
+    console.log(chalk.gray('  ─────────────────────────────────────────────────────'));
+    console.log('');
+    // Group by category
+    const grouped = new Map();
+    for (const skill of skills) {
+        const group = grouped.get(skill.category) || [];
+        group.push(skill);
+        grouped.set(skill.category, group);
+    }
+    for (const [category, items] of grouped) {
+        console.log(chalk.bold.white(`  ${category.toUpperCase()}`));
+        for (const item of items) {
+            const nameStr = chalk.cyan(item.name.padEnd(22));
+            const descStr = chalk.gray(item.description);
+            console.log(`    ${nameStr} ${descStr}`);
+        }
+        console.log('');
+    }
+    console.log(chalk.gray('  ─────────────────────────────────────────────────────'));
+    console.log(`  ${chalk.bold.white('Want more?')} 30+ community skills available at:`);
+    console.log(`  ${chalk.cyan('https://github.com/coreyhaines31/marketingskills')}`);
+    console.log('');
+    console.log(chalk.gray('  To add a skill, drop a .md file into the skills/ folder.'));
+    console.log(chalk.gray('  The agent picks them up automatically — no code needed.'));
+    console.log('');
+}
+// ─── Main ───────────────────────────────────────────────────────────
+async function main() {
+    const args = process.argv.slice(2);
+    // Command routing — setup & doctor skip the splash
+    if (args[0] === 'setup') {
+        await runSetup();
+        return;
+    }
+    if (args[0] === 'doctor') {
+        await runDoctor();
+        return;
+    }
+    // ─── First-Run Detection ────────────────────────────────────────
+    const config = loadConfig();
+    if (!config || !config.provider) {
+        console.clear();
+        console.log(openadsGradient(LOGO));
+        console.log(chalk.cyan.bold('\n  Welcome to OpenAds! 🎯'));
+        console.log(chalk.gray('  Looks like this is your first time. Let\'s get you set up.\n'));
+        await runSetup();
+        return;
+    }
+    // ─── Splash Screen ──────────────────────────────────────────────
+    console.clear();
+    console.log('');
+    console.log(openadsGradient(LOGO));
+    console.log('');
+    const cleanProvider = resolveModel(config.provider);
+    const modelName = chalk.cyan.bold(cleanProvider);
+    const googleStatus = config.connectGoogle ? chalk.green('● Connected') : chalk.gray('○ Not connected');
+    const metaStatus = config.metaToken ? chalk.green('● Connected') : chalk.gray('○ Not connected');
+    // Build compact status panel
+    const statusLines = [
+        `  ${chalk.bold.white('Model')}       ${modelName}`,
+        `  ${chalk.bold.white('Google Ads')}  ${googleStatus}`,
+        `  ${chalk.bold.white('Meta Ads')}    ${metaStatus}`,
+        '',
+        `  ${chalk.gray('v0.1.0')}  ${chalk.gray('·')}  ${chalk.gray('AI Command Center for Marketers')}`,
+    ].join('\n');
+    console.log(boxen(statusLines, {
+        padding: { top: 1, bottom: 1, left: 2, right: 2 },
+        margin: { top: 0, bottom: 1, left: 2, right: 2 },
+        borderStyle: 'round',
+        borderColor: 'cyan',
+        dimBorder: true,
+    }));
+    // ─── Interactive Menu (when no args) ────────────────────────────
+    let finalArgs = [...args];
+    if (args.length === 0) {
+        const { action } = await enquirer.prompt({
+            type: 'select',
+            name: 'action',
+            message: chalk.bold('What would you like to do?'),
+            choices: [
+                { name: 'chat', message: `${chalk.cyan('💬')}  Ask anything` },
+                { name: 'audit', message: `${chalk.cyan('🔍')}  Audit my ad campaigns ${chalk.gray('(audit)')}` },
+                { name: 'copy', message: `${chalk.cyan('✍️')}   Write ad copy for any platform ${chalk.gray('(copywriting)')}` },
+                { name: 'autoresearch', message: `${chalk.cyan('🔄')}  Test and improve ideas automatically ${chalk.gray('(autoresearch)')}` },
+                { name: 'gtm', message: `${chalk.cyan('📈')}  Build a go-to-market plan ${chalk.gray('(strategy)')}` },
+                { name: 'skills', message: `${chalk.cyan('📚')}  Browse available skills` },
+                { name: 'setup', message: `${chalk.gray('⚙️')}   Settings` },
+                { name: 'doctor', message: `${chalk.gray('🩺')}  Diagnostics` },
+                { name: 'exit', message: `${chalk.gray('❌')}  Exit` }
+            ]
+        });
+        if (action === 'exit') {
+            console.log(chalk.cyan('\n  Goodbye! Keep marketing 🎯\n'));
+            return;
+        }
+        if (action === 'setup') {
+            await runSetup();
+            return;
+        }
+        if (action === 'doctor') {
+            await runDoctor();
+            return;
+        }
+        if (action === 'skills') {
+            showSkills();
+            return;
+        }
+        const actionMap = {
+            chat: [],
+            audit: ['audit-google-ads'],
+            copy: ['write-ad-copy'],
+            autoresearch: ['autoresearch-plan'],
+            gtm: ['go-to-market'],
+        };
+        finalArgs = actionMap[action] || [];
+    }
+    // ─── Loading Spinner ────────────────────────────────────────────
+    const spinner = ora({
+        text: chalk.cyan('Starting marketing agent...'),
+        spinner: 'dots12',
+        color: 'cyan',
+    }).start();
+    await new Promise(r => setTimeout(r, 800));
+    // ─── Build Pi Arguments ─────────────────────────────────────────
+    const piArgsRaw = [];
+    // Model flag
+    piArgsRaw.push('--model', cleanProvider);
+    // Skills directories
+    const skillsDir = path.join(pkgDir, 'skills');
+    const templatesDir = path.join(pkgDir, 'templates');
+    // Inject product context as a skill directory
+    const contextDir = injectProductContext(config);
+    const piArgs = [
+        ...piArgsRaw,
+        '--skill', skillsDir,
+        '--prompt-template', templatesDir,
+        ...(contextDir ? ['--skill', contextDir] : []),
+        ...finalArgs
+    ];
+    // ─── Environment Variables ──────────────────────────────────────
+    // API key passed via env var (not CLI flag) for security
+    const env = {
+        ...process.env,
+        NODE_NO_WARNINGS: '1',
+    };
+    if (config.apiKey && config.apiKey !== 'dummy-key') {
+        const envVarName = getApiKeyEnvVar(cleanProvider);
+        env[envVarName] = config.apiKey;
+    }
+    if (config.localBaseUrl) {
+        env.OPENAI_BASE_URL = config.localBaseUrl;
+    }
+    // ─── White-Label Patch ──────────────────────────────────────────
+    const agentDir = path.join(CONFIG_DIR, 'agent');
+    if (!fs.existsSync(agentDir)) {
+        fs.mkdirSync(agentDir, { recursive: true });
+    }
+    const settingsPath = path.join(agentDir, 'settings.json');
+    let settings = {};
+    if (fs.existsSync(settingsPath)) {
+        try {
+            settings = JSON.parse(fs.readFileSync(settingsPath, 'utf8'));
+        }
+        catch (e) { }
+    }
+    settings.quietStartup = true;
+    // System prompt — makes the agent behave as OpenAds
+    settings.systemPrompt = buildSystemPrompt(config);
+    // Resilient retry settings for free-tier rate limits
+    settings.retry = {
+        maxAttempts: 10,
+        baseDelayMs: 15000,
+        provider: { maxRetryDelayMs: 120000 }
+    };
+    // Inject Meta MCP server if token is present
+    if (config.metaToken) {
+        settings.mcpServers = settings.mcpServers || {};
+        settings.mcpServers['meta-ads'] = {
+            command: 'npx',
+            args: ['-y', '@meta/mcp-server'],
+            env: { META_ACCESS_TOKEN: config.metaToken }
+        };
+    }
+    fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2));
+    // ─── Launch Agent ───────────────────────────────────────────────
+    const piCliPath = path.resolve(pkgDir, 'node_modules', '@earendil-works', 'pi-coding-agent', 'dist', 'cli.js');
+    spinner.succeed(chalk.green('Agent ready'));
+    console.log('');
+    if (finalArgs.length === 0) {
+        console.log(chalk.gray('  Type your question or /help for commands\n'));
+    }
+    const child = spawn('node', [piCliPath, ...piArgs], {
+        stdio: 'inherit',
+        env
+    });
+    child.on('exit', (code) => {
+        process.exit(code || 0);
+    });
+}
+main().catch((err) => {
+    console.error(chalk.red('Error:'), err);
+    process.exit(1);
+});

package/dist/doctor.js

@@ -0,0 +1,102 @@
+import chalk from 'chalk';
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+import { spawnSync } from 'child_process';
+import gradient from 'gradient-string';
+const openadsGradient = gradient(['#00d2ff', '#3a7bd5', '#00d2ff']);
+export async function runDoctor() {
+    console.log(openadsGradient('\n  OpenAds Doctor 🩺\n'));
+    console.log(chalk.gray('  Running diagnostics...\n'));
+    const configDir = path.join(os.homedir(), '.openads');
+    const configPath = path.join(configDir, 'openads.config.json');
+    let hasErrors = false;
+    let config = null;
+    console.log(chalk.bold('Configuration'));
+    if (fs.existsSync(configPath)) {
+        console.log(`  ${chalk.green('✓')} Config file found at ${configPath}`);
+        try {
+            config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+            if (config.provider && config.apiKey) {
+                console.log(`  ${chalk.green('✓')} LLM Provider: ${config.provider}`);
+            }
+            else {
+                console.log(`  ${chalk.red('✗')} Missing LLM provider or API key`);
+                hasErrors = true;
+            }
+        }
+        catch (e) {
+            console.log(`  ${chalk.red('✗')} Config file is malformed`);
+            hasErrors = true;
+        }
+    }
+    else {
+        console.log(`  ${chalk.red('✗')} Config file missing. Run 'openads setup'`);
+        hasErrors = true;
+    }
+    console.log(`\n${chalk.bold('Connections')}`);
+    if (config) {
+        // Google Ads Check
+        if (config.connectGoogle) {
+            const adloopTokenPath = path.join(os.homedir(), '.adloop', 'token.json');
+            const adloopCredentialsPath = path.join(os.homedir(), '.adloop', 'credentials.json');
+            if (fs.existsSync(adloopTokenPath)) {
+                console.log(`  ${chalk.green('✓')} Google Ads: Connected (Authenticated at ~/.adloop/token.json)`);
+            }
+            else if (fs.existsSync(adloopCredentialsPath)) {
+                console.log(`  ${chalk.yellow('!')} Google Ads: Configured (OAuth credentials present, token missing. Run 'uvx adloop init')`);
+            }
+            else {
+                console.log(`  ${chalk.red('✗')} Google Ads: Configured but not authenticated (Run 'openads setup')`);
+                hasErrors = true;
+            }
+        }
+        else {
+            console.log(`  ${chalk.gray('✗')} Google Ads: Not Connected`);
+        }
+        // Meta Ads Check
+        if (config.metaToken) {
+            try {
+                const res = await fetch(`https://graph.facebook.com/v21.0/me?access_token=${config.metaToken}`);
+                const data = await res.json();
+                if (res.ok && data.id) {
+                    console.log(`  ${chalk.green('✓')} Meta Ads: Connected (Token is active)`);
+                }
+                else {
+                    const errMsg = data.error?.message || 'Invalid Access Token';
+                    console.log(`  ${chalk.red('✗')} Meta Ads: Connection failed — ${errMsg}`);
+                    hasErrors = true;
+                }
+            }
+            catch (e) {
+                console.log(`  ${chalk.red('✗')} Meta Ads: Network error verifying token — ${e.message}`);
+                hasErrors = true;
+            }
+        }
+        else {
+            console.log(`  ${chalk.gray('✗')} Meta Ads: Not Connected`);
+        }
+    }
+    else {
+        console.log(`  ${chalk.red('✗')} Google Ads: Cannot verify (missing configuration)`);
+        console.log(`  ${chalk.red('✗')} Meta Ads: Cannot verify (missing configuration)`);
+    }
+    console.log(`\n${chalk.bold('Environment')}`);
+    console.log(`  Node.js: ${process.version}`);
+    console.log(`  OS: ${os.type()} ${os.release()}`);
+    const uvxCheck = spawnSync('uvx', ['--version']);
+    if (uvxCheck.status === 0) {
+        console.log(`  ${chalk.green('✓')} uvx: Installed (Required for Google Ads)`);
+    }
+    else {
+        console.log(`  ${chalk.red('✗')} uvx: Not installed. Run 'curl -LsSf https://astral.sh/uv/install.sh | sh'`);
+        hasErrors = true;
+    }
+    if (hasErrors) {
+        console.log(`\n${chalk.red('Some checks failed. Please run `openads setup` to configure your environment.')}`);
+        process.exit(1);
+    }
+    else {
+        console.log(`\n${chalk.green('All checks passed! You are ready to run OpenAds.')}`);
+    }
+}