Skip to content
StackOS CLI v1.4.0Node.js >= 18 • Zero DependenciesMIT License • $0 Public Tier6-IDE MCP Auto-Installer

StackOS CLI & Node.js SDK — Command-Line AI Plugin & SaaS TCO Router

Authored & Maintained by Vishal Singh (Founder & Principal Product Architect • thevishalrajput@gmail.com)

BLUF Summary: Execute https://stackos-ai.vercel.app/cli.mjs directly from any macOS, Linux, or WSL terminal—or inside autonomous CI/CD and coding-agent shells—to benchmark $0 open-source MCP servers against paid B2B SaaS APIs, generate shareable 10-seat CFO TCO audits, and configure 6 AI IDEs in one command.

1. Instant Zero-Install Execution & Local Binary Setup

Option A — Zero-Install One-Liner (Node.js 18+)
curl -fsSL https://stackos-ai.vercel.app/cli.mjs | node - recommend "elevenlabs hindi voice + n8n crm"
Option B — Install Persistent Binary + Run 10-Seat TCO Audit
curl -fsSL https://stackos-ai.vercel.app/cli.mjs -o stackos && chmod +x stackos && ./stackos tco supabase+cursor+vercel 10
Option C — Auto-Configure All 6 AI IDEs (Claude Code, Cursor, VS Code, Gemini CLI, Windsurf, Codex)
curl -fsSL https://stackos-ai.vercel.app/install.sh | sh

2. CLI Command Reference (stackos-mcp v1.4.0)

StackOS CLI v1.4.0 subcommands, backing API endpoints, and descriptions
SubcommandBacking EndpointWhat It Returns
recommend "<workflow>"POST /api/v1/router

Matches $0 open-source MCP servers alongside optional Freemium/Paid SaaS APIs and prints ready-to-run Claude Code commands.

curl -fsSL https://stackos-ai.vercel.app/cli.mjs | node - recommend "elevenlabs hindi voice + n8n crm"
tco [stack] [seats]GET /tco/[stack]

Computes 12-month & 36-month multi-seat SaaS Total Cost of Ownership and returns a shareable CFO CSV/Markdown/PDF audit permalink.

curl -fsSL https://stackos-ai.vercel.app/cli.mjs | node - tco n8n+apollo+hubspot-crm 10
blueprintsGET /use-cases

Streams all 8 verified multi-tool B2B workflow architectures with $0 bootstrap vs scale TCO.

curl -fsSL https://stackos-ai.vercel.app/cli.mjs | node - blueprints
trends [market]GET /api/v1/keyword-intel

Lists live Google & YouTube search autocomplete trends across 8 global markets (us, in, de, es, fr, br, jp, gb).

curl -fsSL https://stackos-ai.vercel.app/cli.mjs | node - trends in
radarGET /api/v1/community-radar

Fetches real-time Hacker News, Dev.to, and GitHub MCP buyer-intent developer signals.

curl -fsSL https://stackos-ai.vercel.app/cli.mjs | node - radar

3. Zero-Dependency Node.js / TypeScript Fetch SDK Pattern

Embed StackOS directly inside autonomous agent loops, Vercel Functions, or GitHub Actions using native fetch against our typed OpenAPI 3.1 endpoint:

TypeScript / Node.js 18+ Native Fetch Example
// Node.js 18+ / TypeScript Zero-Dependency SDK Pattern
const res = await fetch("https://stackos-ai.vercel.app/api/v1/router", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-API-Version": "2026-11-19"
  },
  body: JSON.stringify({
    query: "Postgres database + Playwright browser QA + Hindi TTS voice",
    platform: "claude-code",
    includePaid: true
  })
});
const decision = await res.json();
console.log(decision.freeAutoConnect, decision.mergedMcpJson);

4. Frequently Asked Questions

Does the StackOS CLI require an API key or npm global install?

No. StackOS CLI v1.4.0 is a zero-dependency ES module that runs directly on Node.js 18+ via curl -fsSL https://stackos-ai.vercel.app/cli.mjs | node - recommend "..." with zero API keys or telemetry.

Which AI coding IDEs does the companion install.sh script configure?

Running curl -fsSL https://stackos-ai.vercel.app/install.sh | sh non-destructively merges the StackOS Remote HTTP MCP server into Claude Code (.mcp.json), Cursor (.cursor/mcp.json), VS Code Copilot (.vscode/mcp.json), Google Gemini CLI (~/.gemini/settings.json), Windsurf (~/.codeium/windsurf/mcp_config.json), and OpenAI Codex CLI (~/.codex/config.toml).

Can autonomous CI/CD pipelines override the StackOS API host?

Yes. Set the STACKOS_API_URL environment variable (default https://stackos-ai.vercel.app) to route requests through an enterprise proxy or staging mirror.