@quantiya/codevibe-gemini-plugin
v1.0.27
Published
Control Gemini CLI from your iPhone and Android — real-time sync, approve file edits, send prompts by voice. Part of CodeVibe.
Maintainers
Readme
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
@./pathformat) - 🔔 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 | bashDownload the iOS app or Android app, sign in with the same Apple or Google account, and run:
codevibe-geminiYour session appears on your phone automatically.
Manual install
npm install -g @quantiya/codevibe
codevibe login
codevibe-geminiRequirements
- macOS, Linux, or WSL Ubuntu — Windows without WSL is not supported
- Node.js 18.0.0+
- tmux —
brew install tmuxon macOS,apt install tmuxon 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 outTroubleshooting
# 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 updateSupport
- Email: [email protected]
- 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
