upfynai-code 3.1.0 → 3.2.0

package/README.md

@@ -1,24 +1,20 @@
-# upfyn-code
+# upfynai-code
 
-> Unified AI coding interface — access AI chat, terminal, file explorer, git, and visual canvas from any browser.
+> CLI bridge for the Upfyn ecosystem — connect your machine to code.upfyn.com and control it from any browser, phone, or tablet.
 
-**Upfyn-Code** connects your local development machine to a browser-based UI through a secure, encrypted connection. Write code with AI assistance, run shell commands, manage files, handle git operations, and plan on a visual canvas — all from any device, anywhere.
+**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.
 
 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.
+
 ## Install
 
 ```bash
 npm install -g upfynai-code
 ```
 
-Or run directly with npx:
-
-```bash
-npx upfynai-code
-```
-
-**Requirements:** Node.js 22 or later. Works on Windows, macOS, and Linux.
+**Requirements:** Node.js 18 or later. Works on Windows, macOS, and Linux.
 
 ## Quick Start
 
@@ -29,78 +25,84 @@ uc login
 # 2. Connect your machine to the web interface
 uc connect
 
-# 3. Open the web UI (opens automatically)
+# 3. Or start the local UI server
 uc start
 ```
 
-Once connected, open [cli.upfyn.com](https://cli.upfyn.com) on any device to access your full development environment.
+Once connected, open [code.upfyn.com](https://code.upfyn.com) on any device to access your full development environment.
 
 ## Commands
 
 | Command | Description |
 |---------|-------------|
-| `uc` | Launch Claude Code with Upfyn web UI in background |
-| `uc start` | Start the web UI server |
-| `uc connect` | Connect your local machine to the cloud interface |
+| `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 status` | Show current configuration |
+| `uc mcp` | Show MCP integration config for Claude/Cursor |
 | `uc config` | View or set configuration |
-| `uc help` | Show all available commands |
 
-### Connect Options
+## The Ecosystem
 
-```bash
-uc connect --key <token>
-```
+Upfyn-Code is part of a three-part ecosystem:
+
+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
+
+All three connect to the same cloud relay. Use whichever fits your workflow — they're interchangeable.
 
-- `--key <token>` — Your connection token (get from the web UI after signing in)
+## AI Modes
+
+The web app supports three AI modes that change how the agent works:
+
+- **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
 
 ## Features
 
 ### AI Chat
-Converse with AI coding assistants to write, debug, and refactor code across any language. Supports multiple AI models.
+Multi-model AI chat with Plan/Code/Analyse modes. Supports Claude, Codex, and BYOK providers.
 
 ### Integrated Terminal
-Run shell commands on your connected machine directly from the browser. Full terminal emulation with command history.
+Full PTY terminal emulation from the browser. Run any command on your connected machine.
 
 ### File Explorer
-Browse, create, edit, and manage your entire project tree remotely. Supports drag-and-drop, file search, and bulk operations.
+Browse, edit, and manage project files remotely with syntax highlighting.
 
 ### Git Management
-Visual git interface for commits, branches, diffs, and merges. Stage changes, resolve conflicts, and manage branches without leaving the browser.
-
-### Upfyn Canvas
-Visual whiteboard with AI-powered blocks for planning and collaboration. Connect chat, research, code, and documentation blocks into context flows.
+Visual git interface — commits, branches, diffs, merges, and conflict resolution.
 
 ### MCP Protocol
-Connect external tools and services via the Model Context Protocol. Use Upfyn-Code as an MCP server with Claude Desktop, Cursor, and other compatible tools.
+Use Upfyn-Code as an MCP server with Claude Desktop, Cursor, and other compatible tools.
 
 ## How It Works
 
 1. **Install** the CLI on your development machine
-2. **Authenticate** with `uc login`
-3. **Connect** with `uc connect` — creates a secure, encrypted connection
-4. **Open** [cli.upfyn.com](https://cli.upfyn.com) on any browser (desktop, tablet, or mobile)
+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)
 
-The CLI connects your local filesystem, terminal, and git to the web interface. No ports are exposed and no firewall configuration is needed.
+No ports are exposed and no firewall configuration is needed.
 
 ## Security
 
-- All communication is encrypted end-to-end
-- Source code is **never stored** on servers
-- Secure authentication with automatic session management
-- Each user's environment is fully isolated
+- 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
 
 ## Links
 
-- **Website:** [cli.upfyn.com](https://cli.upfyn.com)
-- **Documentation:** [cli.upfyn.com/docs](https://cli.upfyn.com/docs)
+- **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)
-- **Issues:** [github.com/AnitChaudhry/UpfynAI-Code/issues](https://github.com/AnitChaudhry/UpfynAI-Code/issues)
 
 ## License
 
 GPL-3.0 — see [LICENSE](https://github.com/AnitChaudhry/UpfynAI-Code/blob/main/LICENSE) for details.
 
-Built by [Upfynai-Code](https://cli.upfyn.com).
+Built by [Thinqmesh Technologies](https://code.upfyn.com).

package/bin/cli.js

@@ -28,7 +28,7 @@ program
 // ── Web subcommand group ──────────────────────────────────────────
 const web = program
   .command('web')
-  .description('Web UI commands — connect local machine to cli.upfyn.com');
+  .description('Web UI commands — connect local machine to code.upfyn.com');
 
 web
   .command('connect [token]')