kv1nt-connect

One-click connect your local AI agents to kv1nt.com

Quick Start

# Install globally
npm install -g kv1nt-connect

# Or run directly
npx kv1nt-connect

What It Does

1. Detects local AI agents (Ollama, OpenCode)
2. Creates a secure tunnel automatically
3. Shows a connection code
4. Enter the code in kv1nt.com → connected!

Supported Agents

• Ollama - Local models (llama3, mistral, etc.)
• OpenCode - AI coding agent

How It Works

┌─────────────────────┐       ┌─────────────────────┐
│   YOUR TERMINAL     │       │      kv1nt.com     │
│                     │       │                     │
│  $ npx kv1nt-connect     │       │  [Connect Local]    │
│  🔍 Scanning...      │       │        ↓            │
│  ✓ Found Ollama     │       │  KV1NT-4X7K9M2P    │
│  🔗 Tunnel ready    │──────►│  ✓ Connected!      │
│                     │ Code  │                     │
└─────────────────────┘       └─────────────────────┘

Installation

Prerequisites

• Node.js 18+
• cloudflared

Install cloudflared

macOS:

brew install cloudflared

Linux:

curl -L https://github.com/cloudflare/cloudflared/releases/latest/download/cloudflared-linux-amd64 -o cloudflared
chmod +x cloudflared
sudo mv cloudflared /usr/local/bin/

Windows: Download from https://github.com/cloudflare/cloudflared/releases

Usage

npx kv1nt-connect

1. Tool scans for local agents
2. Select which to connect
3. Tunnel created automatically
4. Enter code in kv1nt.com

Development

# Clone repo
git clone https://github.com/eenvywithin/kv1nt-connect.git
cd kv1nt-connect

# Install dependencies
npm install

# Build CLI
npm run build

# Test
npm start

Server

The connection server is a Cloudflare Worker. To deploy:

cd server
npx wrangler deploy

License

MIT