upfynai-code 3.0.4 → 3.2.0

package/README.md

@@ -1,131 +1,108 @@
-# Upfyn-Code
+# upfynai-code
 
-**Visual AI coding interface for Claude Code, Cursor & Codex.**
+> CLI bridge for the Upfyn ecosystem — connect your machine to code.upfyn.com and control it from any browser, phone, or tablet.
 
-Canvas whiteboard, multi-agent chat, integrated terminal, git management, voice assistant, and MCP protocol — all in one browser-based IDE.
+**Upfyn-Code CLI** connects your local development machine to the Upfyn web IDE through a secure WebSocket relay. Write code with AI assistance (Plan/Code/Analyse modes), run shell commands, manage files, and handle git — all from any device.
 
-By [Thinqmesh Technologies](https://thinqmesh.com)
+Your source code **never leaves your machine**. All file operations, terminal commands, and git actions execute locally.
 
----
+> **Prefer a GUI?** Download [Upfyn Code Desktop](https://code.upfyn.com/desktop) — same functionality with a native app that auto-connects on login.
 
-## What is Upfyn-Code?
+## Install
 
-Upfyn-Code gives you a **visual web interface** for AI coding agents. Instead of working in a plain terminal, you get a full IDE experience with:
-
-- **Multi-Agent Chat** — Claude Code, Cursor, Codex, and 200+ models via OpenRouter
-- **Visual Canvas** — Infinite whiteboard with AI-powered blocks (Chat, Research, Code, Notes, PDF, Dashboard)
-- **Integrated Terminal** — Multi-tab shell with full ANSI color support
-- **File Explorer** — Browse, edit, and manage project files
-- **Git Panel** — Stage, commit, push, view diffs, switch branches
-- **Voice Assistant** — Talk to Upfyn hands-free
-- **Task Tracker** — AI-powered task breakdown from PRDs
-- **MCP Protocol** — Connect to Claude Code, Cursor, or any MCP-compatible tool
-- **Dashboard** — Session analytics, usage stats, and getting-started guide
-- **BYOK** — Bring Your Own API Key (Anthropic, OpenAI, Google, OpenRouter)
-
----
-
-## Two ways to use it
+```bash
+npm install -g upfynai-code
+```
 
-### 1. Local mode (free, self-hosted)
+**Requirements:** Node.js 18 or later. Works on Windows, macOS, and Linux.
 
-Install the package and run everything on your machine. No account needed.
+## Quick Start
 
 ```bash
-npm install -g upfynai-code
+# 1. Authenticate with your Upfyn account
+uc login
 
-# Launch Claude Code + web UI
-uc
+# 2. Connect your machine to the web interface
+uc connect
 
-# Or start the web server only
+# 3. Or start the local UI server
 uc start
 ```
 
-The server starts at `http://localhost:3001`. It auto-detects your installed AI agents and creates a local user automatically.
+Once connected, open [code.upfyn.com](https://code.upfyn.com) on any device to access your full development environment.
 
-**What you get locally:**
-- Full web UI with all features (chat, canvas, terminal, git, files, tasks)
-- Direct SDK calls to your local Claude Code / Codex / Cursor
-- No network round-trip — everything runs on your machine
-- Works offline (except AI queries which need API access)
+## Commands
 
-### 2. Cloud mode (subscription required)
+| Command | Description |
+|---------|-------------|
+| `uc` | Start local server with web UI |
+| `uc start` | Start the web UI server (same as `uc`) |
+| `uc connect` | Connect your machine to code.upfyn.com |
+| `uc login` | Authenticate with your Upfyn account |
+| `uc logout` | Clear saved credentials |
+| `uc mcp` | Show MCP integration config for Claude/Cursor |
+| `uc config` | View or set configuration |
 
-Access your machine from **any browser, anywhere** via [cli.upfyn.com](https://cli.upfyn.com).
+## The Ecosystem
 
-```bash
-# 1. Sign up at cli.upfyn.com and get your relay token
-# 2. Connect your machine
-uc connect --server https://cli.upfyn.com --key upfyn_your_token
-```
+Upfyn-Code is part of a three-part ecosystem:
 
-Once connected, your local machine is bridged to the web UI. AI prompts, terminal commands, file operations, and git — all route through an encrypted relay to your machine.
+1. **Desktop App** (Tauri + Rust) — Native app with full local access, auto-connects to cloud
+2. **Web App** (code.upfyn.com) — Browser IDE with AI chat, terminal, files, git
+3. **CLI** (this package) — Lightweight bridge for users who prefer the terminal
 
-**What you need for cloud mode:**
-- An active subscription at [cli.upfyn.com/pricing](https://cli.upfyn.com/pricing)
-- Your relay token (provided after signup)
-- The CLI installed on your machine
+All three connect to the same cloud relay. Use whichever fits your workflow — they're interchangeable.
 
-**Why subscribe?**
-- Access your dev environment from any device (phone, tablet, another PC)
-- MCP API access — connect Claude Code or Cursor to Upfyn-Code remotely
-- Voice assistant with daily call allowance
-- Priority support
+## AI Modes
 
----
+The web app supports three AI modes that change how the agent works:
 
-## CLI Commands
+- **Plan** — Explores codebase and designs an approach before writing code
+- **Code** — Default. Reads, writes, and refactors code directly
+- **Analyse** — Read-only. Explains and reviews code without changes
 
-| Command | Description |
-|---------|-------------|
-| `uc` | Launch Claude Code with Upfyn web UI |
-| `uc start` | Start the local web server only |
-| `uc connect --key <token>` | Connect to cli.upfyn.com (subscription required) |
-| `uc config --api-key <key>` | Save your Anthropic API key |
-| `uc status` | Show configuration and data locations |
-| `uc install-commands` | Install `/upfynai-*` slash commands for Claude Code |
-| `uc update` | Update to latest version |
-| `uc help` | Show all commands |
+## Features
 
-## Slash Commands
+### AI Chat
+Multi-model AI chat with Plan/Code/Analyse modes. Supports Claude, Codex, and BYOK providers.
 
-When you run `uc`, these slash commands are automatically available inside Claude Code:
+### Integrated Terminal
+Full PTY terminal emulation from the browser. Run any command on your connected machine.
 
-| Command | Description |
-|---------|-------------|
-| `/upfynai-connect` | Connect CLI session to web UI |
-| `/upfynai-disconnect` | Disconnect from web UI |
-| `/upfynai-status` | Show connection status |
-| `/upfynai-doctor` | Run diagnostics |
+### File Explorer
+Browse, edit, and manage project files remotely with syntax highlighting.
 
-## BYOK (Bring Your Own Key)
+### Git Management
+Visual git interface — commits, branches, diffs, merges, and conflict resolution.
 
-Even without a connected machine, you can use AI chat by adding your own API keys in Settings:
+### MCP Protocol
+Use Upfyn-Code as an MCP server with Claude Desktop, Cursor, and other compatible tools.
 
-- **Anthropic** — Claude models (Sonnet, Opus, Haiku)
-- **OpenAI** — GPT models
-- **OpenRouter** — 200+ models from all providers
-- **Google AI** — Gemini models
+## How It Works
 
-Configure via the web UI (Settings > AI Providers) or CLI:
-```bash
-uc config --api-key sk-ant-api03-your-key
-```
+1. **Install** the CLI on your development machine
+2. **Login** with `uc login` — authenticates once, saves credentials
+3. **Connect** with `uc connect` — creates a secure WebSocket relay
+4. **Open** [code.upfyn.com](https://code.upfyn.com) on any browser (desktop, tablet, or mobile)
 
-## Requirements
+No ports are exposed and no firewall configuration is needed.
 
-- **Node.js 18+**
-- At least one AI agent installed:
-  ```bash
-  npm install -g @anthropic-ai/claude-code  # Claude Code
-  npm install -g @openai/codex              # OpenAI Codex
-  # Cursor — install from cursor.com
-  ```
+## Security
 
-## Documentation
+- All communication encrypted via WSS (TLS)
+- Source code **never stored** on servers — relay only
+- Secure JWT authentication with automatic session management
+- IP pinning prevents session hijacking
 
-Full documentation: [cli.upfyn.com/docs](https://cli.upfyn.com/docs)
+## Links
+
+- **Website:** [code.upfyn.com](https://code.upfyn.com)
+- **Desktop App:** [code.upfyn.com/desktop](https://code.upfyn.com/desktop)
+- **Documentation:** [code.upfyn.com/docs](https://code.upfyn.com/docs)
+- **GitHub:** [github.com/AnitChaudhry/UpfynAI-Code](https://github.com/AnitChaudhry/UpfynAI-Code)
 
 ## License
 
-GPL-3.0 — Thinqmesh Technologies
+GPL-3.0 — see [LICENSE](https://github.com/AnitChaudhry/UpfynAI-Code/blob/main/LICENSE) for details.
+
+Built by [Thinqmesh Technologies](https://code.upfyn.com).

package/bin/cli.js

@@ -0,0 +1,191 @@
+#!/usr/bin/env node
+
+import { Command } from 'commander';
+import { readFileSync } from 'fs';
+import { dirname, join } from 'path';
+import { fileURLToPath } from 'url';
+import { login, logout, status, getToken, validateToken } from '../src/auth.js';
+import { openHosted, startLocal } from '../src/launch.js';
+import { connect } from '../src/connect.js';
+import { mcp } from '../src/mcp.js';
+import { readConfig, writeConfig, clearConfig, DEFAULTS, displayUrl } from '../src/config.js';
+import chalk from 'chalk';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const pkg = JSON.parse(readFileSync(join(__dirname, '..', 'package.json'), 'utf8'));
+
+const program = new Command();
+
+program
+  .name('uc')
+  .description('Upfyn-Code — AI coding environment for your terminal')
+  .version(pkg.version)
+  .action(async () => {
+    // Default: start local server (no login needed)
+    await startLocal();
+  });
+
+// ── Web subcommand group ──────────────────────────────────────────
+const web = program
+  .command('web')
+  .description('Web UI commands — connect local machine to code.upfyn.com');
+
+web
+  .command('connect [token]')
+  .description('Connect this machine to the web UI (uses saved token from login, or provide one)')
+  .option('--server <url>', 'Server URL (default: Upfyn Cloud)')
+  .action(async (token, options) => {
+    await connect({ key: token || undefined, server: options.server });
+  });
+
+web
+  .command('open')
+  .description('Open the hosted web UI in your browser')
+  .action(async () => {
+    await openHosted();
+  });
+
+web
+  .command('status')
+  .description('Show web connection status')
+  .action(async () => {
+    await status();
+  });
+
+web
+  .command('token')
+  .description('Show the saved relay token')
+  .action(() => {
+    const config = readConfig();
+    if (!config.relayKey) {
+      console.log(chalk.yellow('\n  No relay token saved. Run `uc login` first.\n'));
+      return;
+    }
+    const masked = `${config.relayKey.slice(0, 10)}...${config.relayKey.slice(-6)}`;
+    console.log(chalk.bold('\n  Relay Token\n'));
+    console.log(`  Token:  ${chalk.cyan(masked)}`);
+    console.log(chalk.dim(`  Full:   ${config.relayKey}`));
+    console.log(chalk.dim(`  Server: ${displayUrl(config.serverUrl)}\n`));
+  });
+
+web
+  .command('regenerate-token')
+  .description('Generate a new relay token (invalidates old one)')
+  .action(async () => {
+    const token = getToken();
+    if (!token) {
+      console.log(chalk.yellow('\n  Not logged in. Run `uc login` first.\n'));
+      process.exit(1);
+    }
+
+    console.log(chalk.dim('\n  Validating session...'));
+    const user = await validateToken();
+    if (!user) {
+      console.log(chalk.yellow('  Session expired. Run `uc login` to re-authenticate.\n'));
+      process.exit(1);
+    }
+
+    console.log(chalk.dim('  Regenerating relay token...'));
+    try {
+      const config = readConfig();
+      const res = await fetch(`${config.serverUrl}/api/auth/regenerate-token`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json', Authorization: `Bearer ${token}` },
+      });
+      if (!res.ok) {
+        const data = await res.json().catch(() => ({}));
+        console.log(chalk.red(`\n  Failed: ${data.error || 'Unknown error'}\n`));
+        process.exit(1);
+      }
+      const data = await res.json();
+      writeConfig({ relayKey: data.token });
+      console.log(chalk.green(`\n  New relay token saved.`));
+      console.log(chalk.dim(`  Old token is now invalid.`));
+      console.log(chalk.cyan(`\n  Run ${chalk.bold('uc web connect')} to reconnect.\n`));
+    } catch (err) {
+      console.log(chalk.red(`\n  Connection error. Could not reach server.\n`));
+      process.exit(1);
+    }
+  });
+
+// ── Auth commands ─────────────────────────────────────────────────
+program
+  .command('login')
+  .description('Authenticate with your Upfyn account (for web UI)')
+  .option('--server <url>', 'Server URL to authenticate against')
+  .action(async (options) => {
+    await login(options);
+  });
+
+program
+  .command('logout')
+  .description('Clear saved credentials')
+  .action(async () => {
+    await logout();
+  });
+
+// ── Connect (alias for web connect, backward compat) ─────────────
+program
+  .command('connect')
+  .description('Connect local machine to the web UI (alias for: uc web connect)')
+  .option('--server <url>', 'Server URL to connect to')
+  .option('--key <token>', 'Connection token (optional — uses saved token from login)')
+  .action(async (options) => {
+    await connect(options);
+  });
+
+// ── Local server ─────────────────────────────────────────────────
+program
+  .command('start')
+  .description('Start the local UI server (same as running `uc` with no args)')
+  .option('--port <port>', 'Port to listen on', '3001')
+  .action(async (options) => {
+    if (options.port) {
+      writeConfig({ localPort: parseInt(options.port) });
+    }
+    await startLocal();
+  });
+
+// ── MCP config ───────────────────────────────────────────────────
+program
+  .command('mcp')
+  .description('Show MCP integration config for Claude / Cursor')
+  .option('--server <url>', 'Server URL')
+  .option('--key <token>', 'Relay token')
+  .action(async (options) => {
+    await mcp(options);
+  });
+
+// ── Config ───────────────────────────────────────────────────────
+program
+  .command('config')
+  .description('View or update CLI configuration')
+  .option('--server <url>', 'Set the server URL')
+  .option('--port <port>', 'Set the local server port')
+  .option('--reset', 'Reset config to defaults')
+  .action((options) => {
+    if (options.reset) {
+      clearConfig();
+      console.log(chalk.green('\n  Config reset to defaults.\n'));
+      return;
+    }
+    if (options.server) {
+      const cleaned = options.server.replace(/\/+$/, '');
+      writeConfig({ serverUrl: cleaned });
+      console.log(chalk.green(`\n  Server set to: ${displayUrl(cleaned)}\n`));
+      return;
+    }
+    if (options.port) {
+      writeConfig({ localPort: parseInt(options.port) });
+      console.log(chalk.green(`\n  Local port set to: ${options.port}\n`));
+      return;
+    }
+    // Show current config
+    const config = readConfig();
+    console.log(chalk.bold('\n  Upfyn-Code — Config\n'));
+    console.log(`  Server:     ${chalk.cyan(displayUrl(config.serverUrl))}`);
+    console.log(`  Local port: ${chalk.cyan(config.localPort)}`);
+    console.log(`  Logged in:  ${config.token ? chalk.green('Yes') : chalk.yellow('No')}\n`);
+  });
+
+program.parse();