@the-agenticflow/openflows 0.1.8 → 0.1.10

package/.env.example

@@ -4,15 +4,17 @@
 # Quick Start Options:
 # ===================
 # 
-# Option 1: Fireworks AI (Recommended - no proxy needed)
-# ------------------------------------------------------
-# Get your key from: https://fireworks.ai
-FIREWORKS_API_KEY=your-fireworks-api-key
-
-# Option 2: Anthropic Direct
-# --------------------------
+# Option 1: Anthropic Direct (Recommended - no proxy needed)
+# ---------------------------------------------------------
 # Get your key from: https://console.anthropic.com
-# ANTHROPIC_API_KEY=your-anthropic-api-key
+ANTHROPIC_API_KEY=your-anthropic-api-key
+
+# Option 2: Fireworks AI (proxy auto-starts for Claude CLI agents)
+# ----------------------------------------------------------------
+# Get your key from: https://fireworks.ai
+# FIREWORKS_API_KEY=your-fireworks-api-key
+# NOTE: Fireworks doesn't have a native Anthropic endpoint,
+# so the proxy auto-starts to translate Anthropic→OpenAI for Claude CLI
 
 # Option 3: Custom Gateway (requires built-in proxy)
 # --------------------------------------------------

package/bin/openflows.js

@@ -40,23 +40,23 @@ function isPortInUse(port) {
     });
 }
 
-// Check if user needs proxy (no direct API keys, but has gateway config)
+// Check if user needs proxy (for LLM API translation if needed)
 function needsProxy() {
     // If user explicitly set PROXY_URL, respect it
     if (process.env.PROXY_URL) {
         return { needed: false, reason: 'PROXY_URL already set' };
     }
     
-    // If user has Fireworks API key, they can use it directly
-    if (process.env.FIREWORKS_API_KEY) {
-        return { needed: false, reason: 'Fireworks direct mode' };
-    }
-    
     // If user has Anthropic API key, they can use it directly
     if (process.env.ANTHROPIC_API_KEY) {
         return { needed: false, reason: 'Anthropic direct mode' };
     }
     
+    // Fireworks users need proxy for Claude CLI agents (no native Anthropic endpoint)
+    if (process.env.FIREWORKS_API_KEY) {
+        return { needed: true, reason: 'Fireworks requires proxy for Claude CLI compatibility' };
+    }
+    
     // If user has Gateway config but no direct keys, they need proxy
     if (process.env.GATEWAY_URL || process.env.GATEWAY_API_KEY) {
         return { needed: true, reason: 'Gateway configured, no direct keys' };
@@ -70,7 +70,7 @@ function needsProxy() {
 async function startProxy() {
     console.log('[openflows] Starting built-in API proxy...');
     
-    const proxyBinary = path.join(__dirname, '..', 'bin', 'anthropic-proxy-bin');
+    let proxyBinary = path.join(__dirname, '..', 'bin', 'anthropic-proxy-bin');
     
     // Check if proxy binary exists
     if (!fs.existsSync(proxyBinary)) {
@@ -80,6 +80,7 @@ async function startProxy() {
             console.log('[openflows] No built-in proxy found, skipping proxy startup');
             return null;
         }
+        proxyBinary = altProxy;
     }
     
     const proxy = spawn(proxyBinary, [], {
@@ -175,15 +176,18 @@ Commands:
   openflows-dashboard Live monitoring TUI
   openflows-doctor    Diagnostic checks
 
-Environment Variables:
-  FIREWORKS_API_KEY   Use Fireworks AI directly (recommended)
-  ANTHROPIC_API_KEY   Use Anthropic directly
+ Environment Variables:
+  ANTHROPIC_API_KEY   Use Anthropic directly (no proxy needed)
+  FIREWORKS_API_KEY   Use Fireworks AI (proxy auto-starts for Claude CLI)
   GATEWAY_URL         Custom gateway URL (requires proxy)
   GATEWAY_API_KEY     Custom gateway API key
   PROXY_PORT          Port for built-in proxy (default: 8765)
 
 Examples:
-  # Quick start with Fireworks (no proxy needed)
+  # Quick start with Anthropic (no proxy needed)
+  ANTHROPIC_API_KEY=your-key openflows
+
+  # Use Fireworks (proxy auto-starts for Claude CLI agents)
   FIREWORKS_API_KEY=your-key openflows
 
   # Use custom gateway (proxy auto-starts)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@the-agenticflow/openflows",
-  "version": "0.1.8",
+  "version": "0.1.10",
   "description": "Autonomous AI development team — turns GitHub issues into working PRs",
   "main": "index.js",
   "bin": {

package/scripts/install.js

@@ -292,7 +292,7 @@ async function main() {
     }
 
     // Rename binaries to match expected names
-    const binaries = ['agentflow', 'agentflow-setup', 'agentflow-dashboard', 'agentflow-doctor'];
+    const binaries = ['agentflow', 'agentflow-setup', 'agentflow-dashboard', 'agentflow-doctor', 'anthropic-proxy'];
     for (const bin of binaries) {
         const src = path.join(BIN_DIR, bin);
         const dst = path.join(BIN_DIR, `${bin}-bin`);
@@ -301,6 +301,12 @@ async function main() {
             fs.chmodSync(dst, 0o755);
         }
     }
+    
+    // Also ensure anthropic-proxy is executable even if not renamed
+    const proxyBin = path.join(BIN_DIR, 'anthropic-proxy');
+    if (fs.existsSync(proxyBin)) {
+        fs.chmodSync(proxyBin, 0o755);
+    }
 
     if (fs.existsSync(tmpFile)) {
         fs.unlinkSync(tmpFile);