upfynai-code

upfynai-code

CLI bridge for the Upfyn ecosystem — connect your machine to code.upfyn.com and control it from any browser, phone, or tablet.

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 — same functionality with a native app that auto-connects on login.

Install

npm install -g upfynai-code

Requirements: Node.js 18 or later. Works on Windows, macOS, and Linux.

Quick Start

# 1. Authenticate with your Upfyn account
uc login

# 2. Connect your machine to the web interface
uc connect

# 3. Or start the local UI server
uc start

Once connected, open code.upfyn.com on any device to access your full development environment.

Commands

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

The Ecosystem

Upfyn-Code is part of a three-part ecosystem:

• Desktop App (Tauri + Rust) — Native app with full local access, auto-connects to cloud
• Web App (code.upfyn.com) — Browser IDE with AI chat, terminal, files, git
• 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.

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

Multi-model AI chat with Plan/Code/Analyse modes. Supports Claude, Codex, and BYOK providers.

Integrated Terminal

Full PTY terminal emulation from the browser. Run any command on your connected machine.

File Explorer

Browse, edit, and manage project files remotely with syntax highlighting.

Git Management

Visual git interface — commits, branches, diffs, merges, and conflict resolution.

MCP Protocol

Use Upfyn-Code as an MCP server with Claude Desktop, Cursor, and other compatible tools.

How It Works

• Install the CLI on your development machine
• Login with uc login — authenticates once, saves credentials
• Connect with uc connect — creates a secure WebSocket relay
• Open code.upfyn.com on any browser (desktop, tablet, or mobile)

No ports are exposed and no firewall configuration is needed.

Security

• 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: code.upfyn.com
• Desktop App: code.upfyn.com/desktop
• Documentation: code.upfyn.com/docs
• GitHub: github.com/AnitChaudhry/UpfynAI-Code

License

GPL-3.0 — see LICENSE for details.

Built by Thinqmesh Technologies.