builderos-cli 2.0.0 → 2.0.2

package/PUBLISHED.md

@@ -0,0 +1,159 @@
+# 🎉 builderos-cli Published Successfully!
+
+## ✅ Package Information
+
+**Package name**: `builderos-cli`
+**Version**: `2.0.0`
+**Registry**: https://www.npmjs.com/package/builderos-cli
+**Published**: 2026-01-14
+**Maintainer**: audilu <khl0327@gmail.com>
+
+## 📦 Installation
+
+Users can now use the CLI without any installation:
+
+```bash
+npx builderos-cli init
+```
+
+Or install globally:
+
+```bash
+npm install -g builderos-cli
+builderos init
+```
+
+## 🚀 Usage Examples
+
+### Initialize with Remote BuilderOS
+
+```bash
+# Using remote API
+npx builderos-cli init --api-url=https://api.builderos.com
+```
+
+### Initialize with Local BuilderOS
+
+```bash
+# Using local API
+npx builderos-cli init --api-url=http://builder-os.test
+```
+
+### Update Skills
+
+```bash
+# Update existing project's skills
+npx builderos-cli update
+```
+
+### All Options
+
+```bash
+# Show help
+npx builderos-cli --help
+
+# Force reinstall
+npx builderos-cli init --force
+
+# Only install MCP
+npx builderos-cli init --mcp-only
+
+# Only download skills
+npx builderos-cli init --skills-only
+```
+
+## 🎯 What It Does
+
+When users run `npx builderos-cli init`:
+
+1. ✅ Creates `.mcp.json` with MCP configuration
+2. ✅ Downloads skills from BuilderOS API to `.claude/skills/`
+3. ✅ Creates `.builderos` marker file
+4. ✅ Updates `.gitignore` (commented for easy team sharing)
+
+## 🌍 Public Access
+
+The package is now publicly available:
+
+- **npm**: https://www.npmjs.com/package/builderos-cli
+- **unpkg CDN**: https://unpkg.com/builderos-cli@2.0.0/
+- **jsDelivr CDN**: https://cdn.jsdelivr.net/npm/builderos-cli@2.0.0/
+
+Anyone in the world can now use:
+
+```bash
+npx builderos-cli init --api-url=YOUR_BUILDEROS_URL
+```
+
+## 📊 Package Stats
+
+```
+Size: 6.6 kB (tarball)
+Unpacked: 21.5 kB
+Dependencies: 0
+Files: 6
+```
+
+## 🔄 Future Updates
+
+To publish updates:
+
+```bash
+cd /Users/audilu/next/builder-os/cli
+
+# Update version
+npm version patch  # 2.0.0 → 2.0.1
+# or
+npm version minor  # 2.0.0 → 2.1.0
+# or
+npm version major  # 2.0.0 → 3.0.0
+
+# Publish
+npm publish --access public
+```
+
+## 📝 Notes
+
+### Why `builderos-cli` instead of `@builderos/cli`?
+
+- `@builderos` scope doesn't exist on npm
+- Creating a scope requires organization setup
+- `builderos-cli` is simpler and works immediately
+- Still clear and searchable
+
+### 2FA Setup
+
+- Used Safari for Security Key registration (Chrome had issues)
+- Configured Touch ID as 2FA method
+- Publishing now requires Touch ID verification
+
+### Package Warnings
+
+npm showed these warnings (auto-corrected):
+```
+"bin[builderos]" script name was cleaned
+"repository.url" was normalized
+```
+
+These are non-issues and were automatically fixed by npm.
+
+## 🎊 Success Metrics
+
+- ✅ Published successfully
+- ✅ Available via `npx` immediately
+- ✅ No dependencies (lightweight)
+- ✅ Works with any BuilderOS API URL
+- ✅ Fully documented
+- ✅ Zero setup barrier for users
+
+## 🔗 Related
+
+- [README.md](README.md) - Full CLI documentation
+- [PUBLISH.md](PUBLISH.md) - Publishing guide
+- [../CLI-IMPLEMENTATION.md](../CLI-IMPLEMENTATION.md) - Implementation details
+
+---
+
+**Status**: 🚀 **LIVE AND READY FOR USE**
+
+Users worldwide can now initialize BuilderOS in their projects with a single command!

package/README.md

@@ -1,4 +1,4 @@
-# @builderos/cli
+# builderos-cli
 
 BuilderOS CLI - Initialize BuilderOS in any project without requiring local code.
 
@@ -6,13 +6,13 @@ BuilderOS CLI - Initialize BuilderOS in any project without requiring local code
 
 ```bash
 # Initialize BuilderOS in current project
-npx @builderos/cli init
+npx builderos-cli init
 
 # Initialize with remote BuilderOS
-npx @builderos/cli init --api-url=https://api.builderos.com
+npx builderos-cli init --api-url=https://api.builderos.com
 
 # Update skills only
-npx @builderos/cli update
+npx builderos-cli update
 ```
 
 ## 📦 What This Does
@@ -39,7 +39,7 @@ This CLI tool:
 Initialize BuilderOS in current project.
 
 ```bash
-npx @builderos/cli init [options]
+npx builderos-cli init [options]
 ```
 
 **Options:**
@@ -52,19 +52,19 @@ npx @builderos/cli init [options]
 
 ```bash
 # Local development (default)
-npx @builderos/cli init
+npx builderos-cli init
 
 # Remote BuilderOS
-npx @builderos/cli init --api-url=https://api.builderos.com
+npx builderos-cli init --api-url=https://api.builderos.com
 
 # Force reinstall
-npx @builderos/cli init --force
+npx builderos-cli init --force
 
 # Only install MCP, skip skills
-npx @builderos/cli init --mcp-only
+npx builderos-cli init --mcp-only
 
 # Only download skills, skip MCP
-npx @builderos/cli init --skills-only
+npx builderos-cli init --skills-only
 ```
 
 ### `update`
@@ -72,7 +72,7 @@ npx @builderos/cli init --skills-only
 Update skills from BuilderOS API.
 
 ```bash
-npx @builderos/cli update [options]
+npx builderos-cli update [options]
 ```
 
 **Options:**
@@ -82,10 +82,10 @@ npx @builderos/cli update [options]
 
 ```bash
 # Update skills from default API
-npx @builderos/cli update
+npx builderos-cli update
 
 # Update skills from remote API
-npx @builderos/cli update --api-url=https://api.builderos.com
+npx builderos-cli update --api-url=https://api.builderos.com
 ```
 
 ## 🔧 How It Works
@@ -93,7 +93,7 @@ npx @builderos/cli update --api-url=https://api.builderos.com
 ### Architecture
 
 ```
-npx @builderos/cli init
+npx builderos-cli init
     ↓
 1. Create .mcp.json
    - Uses npx @builderos/mcp-client
@@ -137,7 +137,7 @@ Key point: Always uses `npx @builderos/mcp-client`, not local code.
 ```bash
 # Developer has BuilderOS running locally at builder-os.test
 cd ~/projects/my-app
-npx @builderos/cli init
+npx builderos-cli init
 ```
 
 ### Remote Team Collaboration
@@ -145,32 +145,32 @@ npx @builderos/cli init
 ```bash
 # Team uses shared BuilderOS at api.builderos.com
 cd ~/projects/team-app
-npx @builderos/cli init --api-url=https://api.builderos.com
+npx builderos-cli init --api-url=https://api.builderos.com
 ```
 
 ### CI/CD Pipeline
 
 ```bash
 # Automated setup in CI
-npx @builderos/cli init --api-url=$BUILDEROS_API_URL --force
+npx builderos-cli init --api-url=$BUILDEROS_API_URL --force
 ```
 
 ### Multiple Environments
 
 ```bash
 # Development
-npx @builderos/cli init --api-url=https://dev.builderos.com
+npx builderos-cli init --api-url=https://dev.builderos.com
 
 # Staging
-npx @builderos/cli init --api-url=https://staging.builderos.com
+npx builderos-cli init --api-url=https://staging.builderos.com
 
 # Production
-npx @builderos/cli init --api-url=https://api.builderos.com
+npx builderos-cli init --api-url=https://api.builderos.com
 ```
 
 ## 🎯 Comparison with use-builderos.sh
 
-| Feature | @builderos/cli | use-builderos.sh |
+| Feature | builderos-cli | use-builderos.sh |
 |---------|----------------|------------------|
 | **Requires local BuilderOS code** | ❌ No | ✅ Yes (for script itself) |
 | **Works anywhere** | ✅ Yes | ⚠️ Only if script accessible |
@@ -256,7 +256,7 @@ export BUILDEROS_API_URL=https://api.builderos.com
 Then run without `--api-url`:
 
 ```bash
-npx @builderos/cli init
+npx builderos-cli init
 ```
 
 ## 🐛 Troubleshooting
@@ -268,7 +268,7 @@ npx @builderos/cli init
 # npx will download the package
 
 # Or install globally
-npm install -g @builderos/cli
+npm install -g builderos-cli
 builderos init
 ```
 
@@ -279,7 +279,7 @@ builderos init
 curl http://builder-os.test/api/skills
 
 # Try with explicit URL
-npx @builderos/cli init --api-url=http://builder-os.test
+npx builderos-cli init --api-url=http://builder-os.test
 ```
 
 ### Skills not loading
@@ -289,7 +289,7 @@ npx @builderos/cli init --api-url=http://builder-os.test
 ls -la .claude/skills/
 
 # Re-download skills
-npx @builderos/cli update --api-url=http://builder-os.test
+npx builderos-cli update --api-url=http://builder-os.test
 ```
 
 ### MCP not connecting
@@ -315,7 +315,7 @@ npm publish --access public
 Then users can use:
 
 ```bash
-npx @builderos/cli init
+npx builderos-cli init
 ```
 
 ## 🔗 Related

package/index.js

@@ -7,8 +7,8 @@
  * Works purely through BuilderOS HTTP API.
  *
  * Usage:
- *   npx @builderos/cli init [options]
- *   npx @builderos/cli update [options]
+ *   npx builderos-cli init [options]
+ *   npx builderos-cli update [options]
  *
  * Options:
  *   --api-url=<url>     BuilderOS API URL (default: http://builder-os.test)
@@ -61,8 +61,8 @@ if (options.help) {
 BuilderOS CLI v2.0.0
 
 Usage:
-  npx @builderos/cli init [options]
-  npx @builderos/cli update [options]
+  npx builderos-cli init [options]
+  npx builderos-cli update [options]
 
 Commands:
   init      Initialize BuilderOS in current project
@@ -77,16 +77,16 @@ Options:
 
 Examples:
   # Initialize with local BuilderOS
-  npx @builderos/cli init
+  npx builderos-cli init
 
   # Initialize with remote BuilderOS
-  npx @builderos/cli init --api-url=https://api.builderos.com
+  npx builderos-cli init --api-url=https://api.builderos.com
 
   # Update skills only
-  npx @builderos/cli update --skills-only
+  npx builderos-cli update --skills-only
 
   # Force reinstall
-  npx @builderos/cli init --force
+  npx builderos-cli init --force
 `);
   process.exit(0);
 }
@@ -105,11 +105,15 @@ async function fileExists(path) {
 async function fetchAPI(endpoint) {
   try {
     const url = `${options.apiUrl}${endpoint}`;
-    const response = await fetch(url, {
-      headers: {
-        'Host': 'builder-os.test', // For local nginx-proxy
-      },
-    });
+
+    // Only set Host header if API URL is not builder-os.test
+    // (for cases where we need to access through IP but want nginx to route correctly)
+    const headers = {};
+    if (!options.apiUrl.includes('builder-os.test')) {
+      headers['Host'] = 'builder-os.test';
+    }
+
+    const response = await fetch(url, { headers });
 
     if (!response.ok) {
       throw new Error(`HTTP ${response.status}: ${response.statusText}`);
@@ -118,6 +122,8 @@ async function fetchAPI(endpoint) {
     return await response.json();
   } catch (error) {
     console.error(`❌ Error fetching ${endpoint}:`, error.message);
+    console.error(`   URL: ${url}`);
+    console.error(`   Stack:`, error.stack);
     return null;
   }
 }
@@ -166,12 +172,15 @@ async function installSkills() {
 
   // Fetch skills list
   const data = await fetchAPI('/api/skills');
-  if (!data || !data.skills) {
+  if (!data || !data.data) {
     console.log('   ❌ Failed to fetch skills list');
+    if (data) {
+      console.log('   Response structure:', JSON.stringify(Object.keys(data)));
+    }
     return;
   }
 
-  const skills = data.skills;
+  const skills = data.data;
   console.log(`   Found ${skills.length} skills`);
 
   // Create .claude/skills directory
@@ -187,7 +196,7 @@ async function installSkills() {
 
     const skillData = await fetchAPI(`/api/skills/${skill.slug}`);
 
-    if (!skillData || !skillData.content) {
+    if (!skillData || !skillData.data || !skillData.data.content) {
       console.log(`      ⚠️  No content available`);
       failedSkills.push(skill.slug);
       continue;
@@ -199,7 +208,7 @@ async function installSkills() {
 
     // Write skill.md
     const skillPath = join(skillDir, 'skill.md');
-    await writeFile(skillPath, skillData.content);
+    await writeFile(skillPath, skillData.data.content);
 
     console.log(`      ✅ Saved to ${skillDir}/skill.md`);
     successCount++;
@@ -374,7 +383,7 @@ async function main() {
       console.log('✅ Update complete!');
     } else {
       console.log(`❌ Unknown command: ${command}`);
-      console.log('Run "npx @builderos/cli --help" for usage');
+      console.log('Run "npx builderos-cli --help" for usage');
       process.exit(1);
     }
   } catch (error) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "builderos-cli",
-  "version": "2.0.0",
+  "version": "2.0.2",
   "description": "BuilderOS CLI - Initialize BuilderOS in any project without requiring local code",
   "type": "module",
   "main": "index.js",