Package Exports

vcode-cli
vcode-cli/bin/vcode.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (vcode-cli) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

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.

vcode-cli