@quantiya/codevibe-gemini-plugin

CodeVibe for Gemini CLI

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.

🌐 quantiya.ai/codevibe — landing page, demo video, and one-liner installer

📱 Download on the App Store · Get it on Google Play

Why CodeVibe for Gemini CLI

• 🚀 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

Install in 30 seconds

curl -fsSL https://quantiya.ai/codevibe/install.sh | bash

Download the iOS app or Android app, sign in with the same Apple or Google account, and run:

codevibe-gemini

Your session appears on your phone automatically.

Manual install

npm install -g @quantiya/codevibe
codevibe login
codevibe-gemini

Requirements

• 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)

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.

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.

CLI commands

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

Troubleshooting

# Check server logs
tail -f /tmp/codevibe-gemini-mcp.log

# Verify tmux session
tmux list-sessions | grep codevibe-gemini

# Reinstall if hooks aren't firing
codevibe update

Support

• Email: [e-mail]
• Landing page: quantiya.ai/codevibe
• Privacy policy: quantiya.ai/privacy

Part of the CodeVibe family

• @quantiya/codevibe — meta-package (install this, not this plugin directly)
• @quantiya/codevibe-core — shared library used by all plugins
• @quantiya/codevibe-claude-plugin — Claude Code support
• @quantiya/codevibe-codex-plugin — OpenAI Codex CLI support

License

MIT