V Code CLI

Connect your local machine to Vynthen V Code — a powerful AI code agent with full system control, secure keychain auth, and human-in-the-loop permissions.

  ╔═══════════════════════════════════════════════════════╗
  ║     ██╗   ██╗     ██████╗ ██████╗ ██████╗ ███████╗    ║
  ║     ██║   ██║    ██╔════╝██╔═══██╗██╔══██╗██╔════╝    ║
  ║     ██║   ██║    ██║     ██║   ██║██║  ██║█████╗      ║
  ║     ╚██╗ ██╔╝    ██║     ██║   ██║██║  ██║██╔══╝      ║
  ║      ╚████╔╝     ╚██████╗╚██████╔╝██████╔╝███████╗    ║
  ║       ╚═══╝       ╚═════╝ ╚═════╝ ╚═════╝ ╚══════╝    ║
  ║              ┌──────────────────────┐                  ║
  ║              │    ◉            ◉    │                  ║
  ║              │         ───         │                  ║
  ║              └──────────────────────┘                  ║
  ╚═══════════════════════════════════════════════════════╝

Install

npm install -g vcode-cli

Quick Start

# 1. Login with your Vynthen account
vcode login

# 2. Navigate to your project
cd /path/to/your/project

# 3. Start the bridge
vcode start

Then open vynthen.com and use V Code — it will operate on your local machine through the secure bridge.

Commands

| Command | Description | |---------|-------------| | vcode login | Authenticate with your Vynthen email and password | | vcode start | Start the V Code bridge and connect to Vynthen | | vcode start --approve-all | Start with all operations auto-approved | | vcode logout | Clear stored authentication token | | vcode status | Show connection status and logged-in user | | vcode --version | Show version |

What Can V Code Do?

Once connected, V Code can perform operations on your local machine — every single operation requires your explicit approval in the terminal.

File System

• 📖 Read files and directories
• ✏️ Create, edit, and write files
• 📁 Create and delete directories
• 🔄 Rename and move files

Terminal

• ⚡ Execute any shell command
• 📦 Run scripts and install packages

Desktop Control

• 🖱️ Mouse: move, click, right-click, double-click, drag
• ⌨️ Keyboard: type text, press key combinations
• 📸 Screenshot: capture full screen or specific window

System

• 📂 Open folders in file manager
• 🌐 Open URLs in browser
• 📋 Read and write clipboard
• 🔍 List and manage running processes

Permission System

Every operation is color-coded by risk level:

• 🔴 Red — Destructive operations (delete, kill process)
• 🟡 Yellow — Read operations (read file, screenshot)
• 🔵 Blue — Write operations (create, edit file)
• 🟣 Purple — Execute operations (run command, open URL)

When V Code requests an operation, you'll see:

  🔵 WRITE  V Code wants to write file
  Details: /home/user/project/index.js

  Allow this operation? (Y/n/a)
    y — Yes, approve this operation
    n — No, deny this operation
    a — Approve all for this session

Security

• 🔐 OS Keychain — JWT stored in your system's native credential store (libsecret on Linux, Keychain on macOS, Credential Manager on Windows). Never stored in plain text.
• ⏱️ 8-Hour JWT — Tokens expire automatically. Run vcode login to refresh.
• 🛑 Human-in-the-Loop — Zero automatic operations. Every action needs your explicit y approval.
• 🔒 Encrypted Transport — All traffic over WSS (encrypted WebSocket).
• 📝 Audit Log — Every approved and denied operation is logged to ~/.vcode/audit.log.
• 🚦 Rate Limited — Login is rate-limited to 5 attempts per 15 minutes.

Audit Log

All operations are logged locally at ~/.vcode/audit.log:

[2026-04-04T10:30:15.123Z] APPROVED READ_FILE             /home/user/project/src/app.tsx
[2026-04-04T10:30:18.456Z] APPROVED WRITE_FILE            /home/user/project/src/app.tsx
[2026-04-04T10:30:22.789Z] DENIED   DELETE_FILE            /home/user/project/.env
[2026-04-04T10:30:25.012Z] APPROVED EXEC_COMMAND           `npm run build` in /home/user/project

System Requirements

• Node.js ≥ 18.0.0
• OS: Linux, macOS, or Windows
• For mouse/keyboard control: @nut-tree/nut-js (optional, installed separately)

Troubleshooting

"Not authenticated" error

Run vcode login to authenticate with your Vynthen account.

"Token expired" error

Your JWT has expired (8-hour lifetime). Run vcode login again.

Mouse/keyboard features not working

Install the optional native module:

npm install -g @nut-tree/nut-js

Connection issues

Check your internet connection and ensure wss://vynthen.com is accessible. The CLI will auto-reconnect with exponential backoff.

License

MIT © Vynthen