@contextai-core/cli 0.1.4 → 0.1.6

package/MCP_GUIDE.md

@@ -26,9 +26,29 @@ The `contextai` CLI now exposes three "Agent-Aware" commands.
 ## 2. Native MCP Server (Official Support)
 For environments that support the full Model Context Protocol (like **Claude Desktop** or **Smithery**), you can configure ContextAI as a native server.
 
-### Claude Desktop Configuration
+### 1. Install Globally (Recommended for Speed & Offline)
+Run this once in your terminal:
+```bash
+npm install -g @contextai-core/cli
+```
+
+### 2. Configure Claude Desktop
 Add this to your `claude_desktop_config.json`:
 
+```json
+{
+  "mcpServers": {
+    "contextai": {
+      "command": "contextai",
+      "args": ["mcp"]
+    }
+  }
+}
+```
+*Note: This runs the locally installed binary. It is instant and works offline.*
+
+### Alternative: npx (Zero-Install)
+If you prefer not to install globally, use `npx`. Note that this checks for updates on every run, which may be slower.
 ```json
 {
   "mcpServers": {

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@contextai-core/cli",
-    "version": "0.1.4",
+    "version": "0.1.6",
     "description": "Give your AI agents persistent memory. Install pre-built context packs for Cursor, Windsurf, Copilot & more.",
     "author": "ContextAI",
     "license": "ISC",
@@ -29,7 +29,6 @@
         "MCP_GUIDE.md",
         "README.md"
     ],
-    "type": "module",
     "dependencies": {
         "@modelcontextprotocol/sdk": "^1.25.1",
         "@supabase/supabase-js": "^2.89.0",
@@ -42,4 +41,4 @@
         "ora": "^8.0.0",
         "zod": "^4.2.1"
     }
-}
+}

package/src/actions/init.js

@@ -3,13 +3,34 @@ import chalk from "chalk";
 import path from "path";
 import fs from "fs";
 
+/**
+ * Standard AGENTS.md content
+ * The vendor-neutral standard for AI agent context
+ */
+const AGENTS_MD_CONTENT = `# AI Agent Context
+<!-- Auto-generated by ContextAI — Do not edit, managed by .ai/ -->
+
+## 🚨 Boot Protocol
+
+**System:** ContextAI (Unified Context Protocol)
+**Root Context:** \`.ai/boot.md\`
+
+**Instructions for Agents:**
+1.  Read \`.ai/boot.md\` immediately.
+2.  Follow the boot protocol described there.
+3.  Load the project state from \`.ai/*/context/MASTER.md\`.
+
+> This file adheres to the [AGENTS.md](https://agents.md) standard for AI discovery.
+`;
+
 /**
  * Initializes the ContextAI Shared Brain (.ai).
- * Creates the directory structure but installs NO packs by default.
+ * Creates directory structure and the generic AGENTS.md discovery file.
  */
 export async function init() {
     console.log(chalk.green('🧠 Initializing ContextAI Shared Brain...'));
-    const aiDir = path.join(process.cwd(), '.ai');
+    const cwd = process.cwd();
+    const aiDir = path.join(cwd, '.ai');
 
     // 1. Create .ai directory if missing
     if (!fs.existsSync(aiDir)) {
@@ -19,8 +40,94 @@ export async function init() {
         console.log(chalk.yellow('   .ai/ directory already exists.'));
     }
 
+    // 2. Create context.json manifest if missing
+    const manifestPath = path.join(aiDir, 'context.json');
+    if (!fs.existsSync(manifestPath)) {
+        fs.writeFileSync(manifestPath, JSON.stringify({
+            version: "1.0.0",
+            packages: {}
+        }, null, 2));
+        console.log(chalk.blue('   Created context.json manifest.'));
+    }
+
+    // 3. Create boot.md router
+    const bootPath = path.join(aiDir, 'boot.md');
+    if (!fs.existsSync(bootPath)) {
+        fs.writeFileSync(bootPath, `# AI Context System
+
+> **Agents: Start here.**
+
+## Installed Packs
+Check \`context.json\` for installed packs, then read the boot.md inside each pack.
+
+## Quick Boot
+\`\`\`bash
+# 1. Find installed packs
+cat .ai/context.json
+
+# 2. Read the pack's boot protocol
+cat .ai/<pack-name>/boot.md
+
+# 3. Load project state
+cat .ai/<pack-name>/context/MASTER.md
+\`\`\`
+
+## No Pack Installed?
+Run: \`npx contextai install @newraozxcode/ucp\`
+`);
+        console.log(chalk.blue('   Created boot.md router.'));
+    }
+
+    // 4. Create AGENTS.md (The Standard)
+    console.log(chalk.blue('\n📡 Configuring agent discovery...'));
+    const agentsPath = path.join(cwd, 'AGENTS.md');
+
+    if (!fs.existsSync(agentsPath)) {
+        fs.writeFileSync(agentsPath, AGENTS_MD_CONTENT);
+        console.log(chalk.green('   ✓ Created AGENTS.md (Standard)'));
+    } else {
+        console.log(chalk.gray('   AGENTS.md already exists, skipping.'));
+    }
+
+    // 5. Inject link into README.md
+    const readmePath = path.join(cwd, 'README.md');
+    const linkText = `\n\n> 🤖 **AI Agents:** Please read [AGENTS.md](AGENTS.md) for context.`;
+
+    if (fs.existsSync(readmePath)) {
+        const content = fs.readFileSync(readmePath, 'utf8');
+        if (!content.includes('AGENTS.md')) {
+            fs.appendFileSync(readmePath, linkText);
+            console.log(chalk.green('   ✓ Updated README.md with agent link'));
+        } else {
+            console.log(chalk.gray('   README.md already has agent link.'));
+        }
+    } else {
+        fs.writeFileSync(readmePath, `# Project\n${linkText}`);
+        console.log(chalk.green('   ✓ Created README.md with agent link'));
+    }
+
+    // 6. Update .gitignore if exists
+    const gitignorePath = path.join(cwd, '.gitignore');
+    if (fs.existsSync(gitignorePath)) {
+        let gitignore = fs.readFileSync(gitignorePath, 'utf8');
+        const additions = ['.ai/*/context/active/', '.ai/*/archive/'];
+        let added = false;
+
+        for (const pattern of additions) {
+            if (!gitignore.includes(pattern)) {
+                gitignore += `\n${pattern}`;
+                added = true;
+            }
+        }
+
+        if (added) {
+            fs.writeFileSync(gitignorePath, gitignore);
+            console.log(chalk.blue('   Updated .gitignore with context exclusions.'));
+        }
+    }
+
     console.log(chalk.green('\n✅ Initialization Complete!'));
-    console.log(chalk.white('   Your project is ready context.'));
+    console.log(chalk.white('   Your project is ready for AI context.'));
     console.log(chalk.cyan('\n   Next Step: Install a Context Pack'));
     console.log(chalk.gray('   $ npx contextai install @<username>/ucp'));
 }

package/src/actions/install.js

@@ -18,6 +18,11 @@ function loadCredentials() {
 }
 
 export async function installPackage(packageSlug, options = {}) {
+    // Special Alias for UCP
+    if (packageSlug === 'ucp') {
+        packageSlug = '@contextai/ucp';
+    }
+
     const spinner = ora(`Installing ${packageSlug}...`).start();
 
     const aiDir = path.join(process.cwd(), '.ai');
@@ -33,7 +38,9 @@ export async function installPackage(packageSlug, options = {}) {
         // 1. Fetch pack from Supabase
         spinner.text = `Fetching pack info for ${packageSlug}...`;
 
-        const { data: purchaseData, error: purchaseError } = await getSupabase()
+        const supabase = getSupabase();
+
+        const { data: pack, error } = await supabase
             .from('packs')
             .select('*')
             .eq('slug', packageSlug)
@@ -124,7 +131,7 @@ export async function installPackage(packageSlug, options = {}) {
         let targetDir = '';
         if (packageSlug.startsWith('@')) {
             const [scope, name] = packageSlug.substring(1).split('/');
-            targetDir = path.join(aiDir, '@' + scope, name);
+            targetDir = path.join(aiDir, `${scope}-${name}`);
         } else {
             targetDir = path.join(aiDir, packageSlug);
         }
@@ -153,10 +160,13 @@ export async function installPackage(packageSlug, options = {}) {
             const tempDir = path.join(os.tmpdir(), `contextai-${Date.now()}`);
             zip.extractAllTo(tempDir, true);
 
-            // Find actual root
-            const items = fs.readdirSync(tempDir);
-            const rootItem = items.find(i => fs.statSync(path.join(tempDir, i)).isDirectory());
-            const sourceDir = rootItem ? path.join(tempDir, rootItem) : tempDir;
+            // Find actual root (only unwrap if it's a single folder)
+            const items = fs.readdirSync(tempDir).filter(i => !i.startsWith('.') && i !== '__MACOSX');
+            let sourceDir = tempDir;
+
+            if (items.length === 1 && fs.statSync(path.join(tempDir, items[0])).isDirectory()) {
+                sourceDir = path.join(tempDir, items[0]);
+            }
 
             spinner.text = 'Injecting Verified Context...';
             copyRecursiveSync(sourceDir, targetDir);
@@ -240,7 +250,7 @@ async function installFromLocal(localPkg, packageName, aiDir, manifestPath, spin
         targetDir = path.join(aiDir, 'ucp');
     } else if (packageName.startsWith('@')) {
         const [scope, name] = packageName.substring(1).split('/');
-        targetDir = path.join(aiDir, '@' + scope, name);
+        targetDir = path.join(aiDir, `${scope}-${name}`);
     } else {
         targetDir = path.join(aiDir, packageName);
     }