v – Terminal-Based Vibe Coding

Code anywhere. Your server, your AI, your way.

A privacy-first mobile IDE that connects to your SSH server, letting you vibe code with CLI-based AI tools like Gemini CLI, Qwen CLI, Claude Code, and more. Generate projects, write code, and preview results—all from your phone.

---

What It Does

v transforms your phone into an AI-powered terminal workspace:

1. Connect via SSH to your own server (BYOS - Bring Your Own Server)
2. Use CLI AI tools to generate and build projects through the terminal
3. Run commands with full terminal access and multi-tab support
4. Preview live with built-in WebView for instant feedback

No desktop IDE needed. Just SSH, terminal, AI CLI tools, and preview.

---

Core Features

🔐 SSH Connection

• Password and private key authentication
• Auto-reconnect and connection status
• Works with any Linux server (VPS, cloud, local)

💻 Terminal Interface

• Up to 5 terminal tabs for multitasking
• Full xterm/VT100 emulation with ANSI colors
• Touch-optimized keyboard with special keys (ESC, CTRL, arrows)
• Perfect for CLI-based AI coding tools

🤖 AI-First Workflow

• Designed for terminal AI assistants (Gemini CLI, Qwen CLI, Claude Code, etc.)
• Chat with AI, generate code, run commands
• Pure CLI experience—no file browser complexity
• Vibe code with your favorite AI tools

🌐 Live Preview

• Built-in WebView for instant app preview
• Connect to dev servers running on your SSH server
• Custom URL support for any preview needs
• Real-time updates as you code

🎨 Modern Design

• iOS 26 Liquid Glass native navigation
• Sleek dark theme optimized for coding
• Touch-friendly interface built for mobile
• Portrait-optimized mobile experience

---

Tech Stack

• Flutter – Cross-platform mobile framework
• dartssh2 – Secure SSH/SFTP connections
• xterm – Full terminal emulation
• webview_flutter – Live preview
• Native iOS Swift – Liquid Glass navigation

---

Requirements

• iOS 26.0 or later
• iPhone (portrait mode only)
• SSH server with your AI CLI tools installed
• tmux installed on your server (for persistent terminal sessions)

---

Getting Started

1. Set up your server with SSH access (any Linux VPS)
2. Install tmux on your server:
   • macOS: brew install tmux
   • Linux: sudo apt install tmux (or yum, dnf, pacman)
3. Install your AI CLI tools (Gemini CLI, Qwen, Claude Code, etc.)
4. Download v and connect with your SSH credentials
5. Open terminal and start vibing with AI
6. Generate projects using your CLI AI assistant
7. Preview live with the built-in WebView

---

Vision

We're building the future of mobile development:

Current: Terminal-based vibe coding with CLI AI tools and live preview
Next: Enhanced AI integrations, tmux support, session recording
Future: Zero-computer development with advanced AI pair programming

No vendor lock-in. No cloud subscriptions. Just your server, your AI tools, and your code.

---

Philosophy

• BYOS – Your server, your data, your control
• Privacy-First – Code never touches third-party servers
• AI-Native – Built for CLI AI coding tools
• Mobile-First – Designed for phones, not adapted from desktop
• Terminal-Centric – Pure CLI workflow for maximum flexibility

---

Contributing

Help us build the future of mobile vibe coding:

• 🐛 Report bugs and suggest features
• 💻 Contribute code improvements
• 🧪 Test with different AI CLI tools and servers
• 📖 Share your vibe coding workflow

---

The future of development is mobile. Let's vibe. 🚀