@quantiya/codevibe-gemini-plugin 1.0.5 → 1.0.7

package/README.md

@@ -1,117 +1,94 @@
-# CodeVibe Gemini Plugin
+# CodeVibe for Gemini CLI
 
-Mobile companion for Gemini CLI - monitor and control your Gemini CLI sessions from your phone.
+**Control Gemini CLI from your iPhone and Android.** See your agent's work, approve file edits, dictate prompts by voice — all from your phone, anywhere you are.
 
-## Overview
+🌐 **[quantiya.ai/codevibe](https://quantiya.ai/codevibe)** — landing page, demo video, and one-liner installer
 
-CodeVibe Gemini Plugin syncs your Gemini CLI sessions with the CodeVibe mobile app, allowing you to:
-- **Approve or deny file edits from your phone** - See file diffs before approving
-- View Gemini conversations on your phone in real-time
-- Send prompts to Gemini from your phone
-- Send image attachments from iOS (Gemini analyzes them)
-- Monitor multiple coding sessions from anywhere
-- Works alongside Claude Code sessions in the same app
+📱 **[Download on the App Store](https://apps.apple.com/app/id6756500217)** · **[Get it on Google Play](https://play.google.com/store/apps/details?id=ai.quantiya.app.codevibe)**
 
-## Prerequisites
+---
 
-- **macOS** (required for tmux integration)
-- **Node.js 18+**
-- **tmux** (`brew install tmux`)
-- **Gemini CLI** installed and authenticated
-- **CodeVibe mobile app** installed on your iPhone
+## Why CodeVibe for Gemini CLI
 
-## Installation
+- **🚀 Real-time sync** — every prompt, response, and tool call shows up on your phone in 100–500ms
+- **✅ Approve from anywhere** — review full file diffs and approve or reject tool execution from your phone
+- **🎙️ Voice prompts** — dictate your next prompt with speech-to-text
+- **📷 Image attachments** — send screenshots and photos; Gemini analyzes them directly (uses `@./path` format)
+- **🔔 Push notifications** — get notified when your agent needs input
+- **🔒 End-to-end encrypted** — AES-256-GCM with ECDH key exchange
+- **🔓 Locked screen support** — works even when your computer screen is locked (via tmux)
+- **🧠 Multi-agent ready** — Gemini sessions appear alongside Claude and Codex sessions in the same app
 
-```bash
-npm install -g @quantiya/codevibe-gemini-plugin
-```
-
-### From Source (Development)
+## Install in 30 seconds
 
 ```bash
-git clone https://github.com/hendryyeh/quantiya-codevibe-gemini-plugin.git
-cd quantiya-codevibe-gemini-plugin
-npm install
-npm run build
+curl -fsSL https://quantiya.ai/codevibe/install.sh | bash
 ```
 
-## Usage
-
-### First Time Setup
+Download the **[iOS app](https://apps.apple.com/app/id6756500217)** or **[Android app](https://play.google.com/store/apps/details?id=ai.quantiya.app.codevibe)**, sign in with the same Apple or Google account, and run:
 
 ```bash
-# Authenticate with backend (opens browser for Sign in with Apple/Google)
-codevibe-gemini login
-
-# Check authentication status
-codevibe-gemini status
+codevibe-gemini
 ```
 
-### Running the Plugin
+Your session appears on your phone automatically.
+
+### Manual install
 
 ```bash
-# Start Gemini with mobile sync
+npm install -g @quantiya/codevibe
+codevibe login
 codevibe-gemini
 ```
 
-The plugin will automatically detect Gemini sessions and sync conversations to your iOS app.
+## Requirements
 
-### CLI Commands
+- **macOS, Linux, or WSL Ubuntu** — Windows without WSL is not supported
+- **Node.js** 18.0.0+
+- **tmux** — `brew install tmux` on macOS, `apt install tmux` on Linux/WSL
+- **Gemini CLI** installed and authenticated (December 2025+ stable release with hook support)
 
-| Command | Description |
-|---------|-------------|
-| `codevibe-gemini` | Start Gemini with mobile sync |
-| `codevibe-gemini login` | Authenticate with backend |
-| `codevibe-gemini logout` | Clear stored credentials |
-| `codevibe-gemini status` | Show authentication status |
+## How it works
 
-## How It Works
+Gemini CLI's hook system (BeforeTool, AfterTool, BeforeAgent, AfterAgent, Notification) captures every agent event and streams it through a local HTTP daemon → AWS AppSync → your phone. Messages from your phone execute in the terminal via `tmux send-keys`, so they work even when your screen is locked.
 
-This plugin uses Gemini CLI's hook system (available in stable releases since December 2025) combined with transcript file watching for complete coverage.
+File diffs are shown in the mobile app with the same numbered options Gemini shows in the terminal, parsed dynamically from the live terminal snapshot — you get accurate options whether it's a file edit, shell command, or custom tool.
 
-**Hook Integration:**
-1. **BeforeTool** - Captures tool approval requests, shows file diffs on iOS, waits for your approval
-2. **AfterTool** - Captures tool execution results
-3. **SessionStart/SessionEnd** - Manages session lifecycle
+## CLI commands
 
-**Transcript Watching:**
-- Monitors `~/.gemini/tmp/*/chats/` for user prompts and assistant responses
-- Provides accurate timestamps for event ordering
+```bash
+codevibe-gemini          # Start Gemini with mobile sync
+codevibe-gemini login    # Authenticate via browser OAuth
+codevibe-gemini status   # Check auth status
+codevibe-gemini logout   # Sign out
+```
 
-**Mobile Integration:**
-- Receives prompts from iOS app via WebSocket subscriptions
-- Executes prompts using tmux send-keys (works even when screen is locked)
+## Troubleshooting
 
-## Known Limitations
+```bash
+# Check server logs
+tail -f /tmp/codevibe-gemini-mcp.log
 
-- Requires tmux for terminal integration (macOS, Linux)
-- **Gemini CLI version**: Hooks require December 2025+ stable release
+# Verify tmux session
+tmux list-sessions | grep codevibe-gemini
 
-## Features
+# Reinstall if hooks aren't firing
+codevibe update
+```
 
-| Feature | Status | Notes |
-|---------|--------|-------|
-| Interactive prompts | ✅ Full | Approve/deny from iOS with file diff preview |
-| User prompts | ✅ Full | Real-time sync to iOS |
-| Assistant responses | ✅ Full | Real-time sync to iOS |
-| File diffs | ✅ Full | Preview changes before approving |
-| Tool results | ✅ Full | See what Gemini executed |
-| Image attachments | ✅ Full | Send images from iOS, uses `@./path` format |
-| Mobile prompts | ✅ Full | Send prompts from iOS, auto-submits |
+## Support
 
-**Full feature parity with Claude Code plugin.**
+- **Email:** support@quantiya.ai
+- **Landing page:** [quantiya.ai/codevibe](https://quantiya.ai/codevibe)
+- **Privacy policy:** [quantiya.ai/privacy](https://quantiya.ai/privacy)
 
-## Related
+## Part of the CodeVibe family
 
-- **CodeVibe iOS App** - Available on the App Store
-- [CodeVibe Claude Plugin](https://github.com/hendryyeh/codevibe-claude-plugin) - For Claude Code
-- [CodeVibe Codex Plugin](https://github.com/hendryyeh/codevibe-codex-plugin) - For OpenAI Codex CLI
+- **[@quantiya/codevibe](https://www.npmjs.com/package/@quantiya/codevibe)** — meta-package (install this, not this plugin directly)
+- **[@quantiya/codevibe-core](https://www.npmjs.com/package/@quantiya/codevibe-core)** — shared library used by all plugins
+- **[@quantiya/codevibe-claude-plugin](https://www.npmjs.com/package/@quantiya/codevibe-claude-plugin)** — Claude Code support
+- **[@quantiya/codevibe-codex-plugin](https://www.npmjs.com/package/@quantiya/codevibe-codex-plugin)** — OpenAI Codex CLI support
 
 ## License
 
-MIT License - See [LICENSE](LICENSE) for details.
-
-## Support
-
-- **Issues:** [GitHub Issues](https://github.com/hendryyeh/quantiya-codevibe-gemini-plugin/issues)
-- **Email:** support@quantiya.ai
+MIT