# 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](https://quantiya.ai/codevibe)** — landing page, demo video, and one-liner installer

📱 **[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)**

---

## 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

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

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
codevibe-gemini
```

Your session appears on your phone automatically.

### Manual install

```bash
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

```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
```

## Troubleshooting

```bash
# 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:** support@quantiya.ai
- **Landing page:** [quantiya.ai/codevibe](https://quantiya.ai/codevibe)
- **Privacy policy:** [quantiya.ai/privacy](https://quantiya.ai/privacy)

## Part of the CodeVibe family

- **[@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