polydev-ai 1.8.71 → 1.8.73

package/README.md

@@ -1,12 +1,40 @@
-# Polydev AI
+# Polydev
 
-**Multi-model AI perspectives for your coding agents.**
+<p align="center">
+  <img src="https://raw.githubusercontent.com/polydev-ai/polydev/main/public/logo.png" alt="Polydev Logo" width="120" />
+</p>
 
-Get insights from GPT 5.2, Claude Opus 4.5, Gemini 3, and Grok 4.1 — all through one MCP server.
+<p align="center">
+  <strong>Multi-model AI perspectives for your coding agents</strong><br>
+  Query GPT-5, Claude, Gemini, and Grok simultaneously through one MCP server
+</p>
 
-[![npm version](https://img.shields.io/npm/v/polydev-ai.svg)](https://www.npmjs.com/package/polydev-ai)
-[![SWE-bench Verified](https://img.shields.io/badge/SWE--bench-74.6%25-brightgreen)](https://polydev.ai/articles/swe-bench-paper)
-[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+<p align="center">
+  <a href="https://www.npmjs.com/package/polydev-ai"><img src="https://img.shields.io/npm/v/polydev-ai.svg" alt="npm version"></a>
+  <a href="https://polydev.ai/articles/swe-bench-paper"><img src="https://img.shields.io/badge/SWE--bench-74.6%25-brightgreen" alt="SWE-bench Verified"></a>
+  <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="License: MIT"></a>
+</p>
+
+---
+
+## 🚀 One-Command Install
+
+### Claude Code
+```sh
+claude mcp add polydev -- npx -y polydev-ai@latest
+```
+
+### Cursor / Windsurf / Cline
+```sh
+npx polydev-ai@latest
+```
+
+### OpenAI Codex CLI
+```sh
+npx polydev-ai@latest
+```
+
+> Get your token at **[polydev.ai/dashboard/mcp-tokens](https://polydev.ai/dashboard/mcp-tokens)**
 
 ---
 
@@ -24,60 +52,64 @@ Get insights from GPT 5.2, Claude Opus 4.5, Gemini 3, and Grok 4.1 — all throu
 
 ---
 
-## 🔑 Key Advantage: Use Your Existing Subscriptions
-
-**Already paying for ChatGPT Plus, Claude Pro, or Gemini Advanced?** Use those subscriptions directly through your CLI tools — no API keys needed.
-
-| Subscription | CLI Tool | How to Use |
-|--------------|----------|------------|
-| Claude Pro ($20/mo) | Claude Code | `claude login` with your Anthropic account |
-| ChatGPT Plus ($20/mo) | Codex CLI | `codex login` with your OpenAI account |
-| Gemini Advanced ($20/mo) | Gemini CLI | `gemini login` with your Google account |
+## How It Works
 
-**How it works:**
-1. Login to your CLI tool with your subscription account (no API keys!)
-2. Add Polydev as an MCP server to your CLI
-3. Polydev queries models through your authenticated CLI sessions
-4. Your subscription quota is used — no extra costs
+```
+Your Agent → Polydev MCP → [GPT-5, Claude, Gemini, Grok] → Synthesized Answer
+```
 
-**No API keys. No double-paying.** Your existing subscriptions just work.
+When your AI agent gets stuck, Polydev consults multiple frontier models simultaneously and returns their combined perspectives. One request, four expert opinions.
 
 ---
 
 ## Quick Start
 
-### 1. Get your free API token
+### Option 1: Use Hosted Service (Recommended)
 
-**[polydev.ai/dashboard/mcp-tokens](https://polydev.ai/dashboard/mcp-tokens)**
+Get started instantly at **[polydev.ai](https://polydev.ai)**
 
-| Tier | Messages/Month | Price |
-|------|----------------|-------|
-| **Free** | 1,000 | $0 |
-| **Pro** | 10,000 | $19/mo |
+**Step 1:** Install the MCP server
+```sh
+npx polydev-ai@latest
+```
 
-### 2. Install
+**Step 2:** Set your token (get it from [polydev.ai/dashboard/mcp-tokens](https://polydev.ai/dashboard/mcp-tokens))
+```sh
+export POLYDEV_USER_TOKEN="pd_your_token_here"
+```
 
-```bash
-npx polydev-ai@latest
+### Option 2: Self-Host with Your Own API Keys
+
+**Step 1:** Clone and install
+```sh
+git clone https://github.com/polydev-ai/polydev.git
+```
+```sh
+cd polydev && npm install
+```
+
+**Step 2:** Configure environment
+```sh
+cp .env.example .env.local
+```
+
+**Step 3:** Add your API keys to `.env.local` and run
+```sh
+npm run dev
 ```
 
 ---
 
-## Setup
+## IDE Configuration
 
 ### Claude Code
 
-```bash
+**One command:**
+```sh
 claude mcp add polydev -- npx -y polydev-ai@latest
 ```
 
-Then set your token:
-```bash
-export POLYDEV_USER_TOKEN="pd_your_token_here"
-```
-
-Or add to `~/.claude.json`:
-
+**Or add to `~/.claude.json`:**
 ```json
 {
   "mcpServers": {
@@ -94,8 +126,7 @@ Or add to `~/.claude.json`:
 
 ### Cursor / Windsurf / Cline
 
-Add to your MCP config:
-
+**Add to your MCP config (usually `~/.cursor/mcp.json` or similar):**
 ```json
 {
   "mcpServers": {
@@ -112,8 +143,7 @@ Add to your MCP config:
 
 ### OpenAI Codex CLI
 
-Add to `~/.codex/config.toml`:
-
+**Add to `~/.codex/config.toml`:**
 ```toml
 [mcp_servers.polydev]
 command = "npx"
@@ -133,12 +163,11 @@ session_timeout = 600
 
 Once connected, your agent can call:
 
-```typescript
+```json
 {
   "tool": "get_perspectives",
   "arguments": {
-    "prompt": "How should I refactor this authentication flow?",
-    "user_token": "pd_your_token_here"
+    "prompt": "How should I refactor this authentication flow?"
   }
 }
 ```
@@ -150,17 +179,58 @@ Or just mention "polydev" or "perspectives" in your prompt:
 "Get perspectives on: Should I use Redis or PostgreSQL for caching?"
 ```
 
-Returns structured perspectives from multiple models with reasoning and recommendations.
+---
+
+## Use Your Existing CLI Subscriptions
+
+**Already paying for ChatGPT Plus, Claude Pro, or Gemini Advanced?** Use those subscriptions directly through your CLI tools.
+
+| Subscription | CLI Tool | Setup |
+|--------------|----------|-------|
+| Claude Pro ($20/mo) | Claude Code | `claude login` |
+| ChatGPT Plus ($20/mo) | Codex CLI | `codex login` |
+| Gemini Advanced ($20/mo) | Gemini CLI | `gemini login` |
+
+Polydev can route requests through your authenticated CLI sessions — your subscription quota is used, no extra API costs.
 
 ---
 
-## How It Works
+## Self-Hosting
+
+### Requirements
+
+- Node.js 18+
+- PostgreSQL (or Supabase)
+- API keys for the models you want to use
+
+### Environment Variables
 
+Create a `.env.local` file:
+
+```sh
+# Database
+NEXT_PUBLIC_SUPABASE_URL=your_supabase_url
+NEXT_PUBLIC_SUPABASE_ANON_KEY=your_anon_key
+SUPABASE_SERVICE_ROLE_KEY=your_service_role_key
+
+# AI Providers (add the ones you want)
+OPENAI_API_KEY=sk-...
+ANTHROPIC_API_KEY=sk-ant-...
+GOOGLE_API_KEY=...
+XAI_API_KEY=...
 ```
-Your Agent → Polydev → [GPT 5.2, Claude Opus 4.5, Gemini 3, Grok 4.1] → Synthesized Answer
+
+### Database Setup
+
+```sh
+cd supabase && supabase db push
 ```
 
-When your AI agent gets stuck, Polydev consults multiple frontier models simultaneously and returns their perspectives. One API call, four expert opinions.
+### Run
+
+```sh
+npm run dev
+```
 
 ---
 
@@ -179,10 +249,52 @@ Our approach achieves **74.6% on SWE-bench Verified** (Resolve@2), matching Clau
 
 ---
 
+## Project Structure
+
+```
+polydev/
+├── src/                    # Next.js application
+│   ├── app/               # App router pages & API routes
+│   ├── components/        # React components
+│   ├── hooks/             # Custom React hooks
+│   └── lib/               # Utilities and services
+├── mcp/                   # MCP server implementation
+├── supabase/              # Database migrations
+├── docs/                  # Documentation
+└── public/                # Static assets
+```
+
+---
+
+## Contributing
+
+Contributions are welcome! Please read our contributing guidelines before submitting PRs.
+
+```sh
+# Fork the repository, then:
+git clone https://github.com/YOUR_USERNAME/polydev.git
+```
+```sh
+cd polydev && npm install
+```
+```sh
+git checkout -b feature/amazing-feature
+```
+```sh
+git commit -m 'Add amazing feature'
+```
+```sh
+git push origin feature/amazing-feature
+```
+
+Then open a Pull Request.
+
+---
+
 ## Links
 
 - **Website:** [polydev.ai](https://polydev.ai)
-- **Dashboard:** [polydev.ai/dashboard](https://polydev.ai/dashboard)
+- **Documentation:** [polydev.ai/docs](https://polydev.ai/docs)
 - **npm:** [npmjs.com/package/polydev-ai](https://www.npmjs.com/package/polydev-ai)
 - **Research:** [SWE-bench Paper](https://polydev.ai/articles/swe-bench-paper)
 
@@ -196,5 +308,5 @@ MIT License - see [LICENSE](LICENSE) for details.
 
 <p align="center">
   <b>Built by <a href="https://polydev.ai">Polydev AI</a></b><br>
-  <i>Multi-model consultation for better code</i>
+  <sub>Multi-model consultation for better code</sub>
 </p>

package/lib/cliManager.js

@@ -781,9 +781,28 @@ This is a known issue with @google/gemini-cli@0.3.4 and older Node.js versions.`
         timeout: timeoutMs,
         // Explicitly pass environment to ensure HOME is available for CLI tools
         // that read config from ~/.config or similar paths (e.g., Gemini CLI)
+        // Also include flags to suppress update prompts and browser opening
         env: {
           ...process.env,
-          HOME: process.env.HOME || os.homedir()
+          HOME: process.env.HOME || os.homedir(),
+          // Suppress interactive prompts and update checks
+          CI: '1',
+          NO_COLOR: '1',
+          TERM: 'dumb',
+          NONINTERACTIVE: '1',
+          // Prevent browser opening (OAuth, updates, etc.)
+          NO_BROWSER: '1',
+          BROWSER: 'echo',  // Redirect browser opening to no-op
+          DISPLAY: '',      // Prevent X11 browser opening
+          HEADLESS: '1',
+          // CLI-specific flags to suppress updates
+          CODEX_DISABLE_UPDATE_CHECK: '1',
+          CLAUDE_CODE_DISABLE_UPDATE_CHECK: '1',
+          GEMINI_NO_BROWSER: '1',
+          GOOGLE_NO_BROWSER: '1',
+          // Prevent package manager update prompts
+          npm_config_update_notifier: 'false',
+          NO_UPDATE_NOTIFIER: '1'
         }
       });
 
@@ -1070,7 +1089,23 @@ This is a known issue with @google/gemini-cli@0.3.4 and older Node.js versions.`
           ...process.env,
           TMPDIR: tmpDir,
           TEMP: tmpDir,
-          TMP: tmpDir
+          TMP: tmpDir,
+          HOME: process.env.HOME || os.homedir(),
+          // Suppress interactive prompts and update checks
+          CI: '1',
+          NO_COLOR: '1',
+          TERM: 'dumb',
+          NONINTERACTIVE: '1',
+          // Prevent browser opening (OAuth, updates, etc.)
+          NO_BROWSER: '1',
+          BROWSER: 'echo',
+          DISPLAY: '',
+          HEADLESS: '1',
+          // CLI-specific flags to suppress updates
+          CODEX_DISABLE_UPDATE_CHECK: '1',
+          // Prevent package manager update prompts
+          npm_config_update_notifier: 'false',
+          NO_UPDATE_NOTIFIER: '1'
         }
       });
 

package/mcp/stdio-wrapper.js

@@ -249,7 +249,17 @@ class StdioMCPWrapper {
   constructor() {
     this.userToken = process.env.POLYDEV_USER_TOKEN;
     if (!this.userToken) {
-      console.error('POLYDEV_USER_TOKEN environment variable is required');
+      console.error('\n╔════════════════════════════════════════════════════════════════╗');
+      console.error('║  POLYDEV_USER_TOKEN is not set                                 ║');
+      console.error('╠════════════════════════════════════════════════════════════════╣');
+      console.error('║  Get your free token at:                                       ║');
+      console.error('║  👉 https://polydev.ai/dashboard/mcp-tokens                    ║');
+      console.error('║                                                                ║');
+      console.error('║  Then add to ~/.zshrc or ~/.bashrc:                            ║');
+      console.error('║  export POLYDEV_USER_TOKEN="pd_your_token_here"                ║');
+      console.error('║                                                                ║');
+      console.error('║  Restart your terminal and Claude Code after adding the token ║');
+      console.error('╚════════════════════════════════════════════════════════════════╝\n');
       process.exit(1);
     }
     

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "polydev-ai",
-  "version": "1.8.71",
+  "version": "1.8.73",
   "engines": {
     "node": ">=20.x <=22.x"
   },
-  "mcpName": "io.github.backspacevenkat/perspectives",
-  "description": "Multi-model AI perspectives for coding agents - query GPT 5.2, Claude Opus 4.5, Gemini 3, and Grok 4.1 simultaneously through one MCP server",
+  "mcpName": "io.github.polydev-ai/polydev",
+  "description": "Multi-model AI perspectives for coding agents - query GPT-5, Claude, Gemini, and Grok simultaneously through one MCP server",
   "keywords": [
     "mcp",
     "model-context-protocol",