JSPM

codevibe-gemini-plugin

1.0.0
  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 3
  • Score
    100M100P100Q20387F
  • License MIT

Mobile companion for Gemini CLI - monitor and control your Gemini CLI sessions from your iPhone

Package Exports

  • codevibe-gemini-plugin
  • codevibe-gemini-plugin/dist/server.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (codevibe-gemini-plugin) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

CodeVibe Gemini Plugin

Mobile companion for Gemini CLI - monitor and control your Gemini CLI sessions from your iPhone.

Overview

CodeVibe Gemini Plugin syncs your Gemini CLI sessions with the CodeVibe iOS 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 iPhone
  • Send image attachments from iOS (Gemini analyzes them)
  • Monitor multiple coding sessions from anywhere
  • Works alongside Claude Code sessions in the same app

Prerequisites

  • macOS (required for AppleScript integration)
  • Node.js 18+
  • Gemini CLI installed and authenticated
  • CodeVibe iOS app installed on your iPhone

Installation

# Clone the repository
git clone https://github.com/hendryyeh/quantiya-codevibe-gemini-plugin.git
cd quantiya-codevibe-gemini-plugin

# Install dependencies
npm install

# Build
npm run build

# Make CLI executable
chmod +x bin/codevibe-gemini

Configuration

  1. Copy the example environment file:
cp .env.example .env.development
  1. Edit .env.development with your AWS configuration (contact Quantiya for credentials)

Usage

First Time Setup

# Authenticate with backend
./bin/codevibe-gemini login
# This opens your browser for Sign in with Apple/Google

# Check authentication status
./bin/codevibe-gemini status

Running the Plugin

# Start the plugin in the same directory where you'll run Gemini
./bin/codevibe-gemini

# In another terminal, start Gemini CLI
gemini

The plugin will automatically detect Gemini sessions and sync conversations to your iOS app.

CLI Commands

Command Description
codevibe-gemini Start the plugin server
codevibe-gemini login Authenticate with backend
codevibe-gemini logout Clear stored credentials
codevibe-gemini status Show authentication status

How It Works

This plugin uses Gemini CLI's hook system (available in stable releases since December 2025) combined with transcript file watching for complete coverage.

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

Transcript Watching:

  • Monitors ~/.gemini/tmp/*/chats/ for user prompts and assistant responses
  • Provides accurate timestamps for event ordering

Mobile Integration:

  • Receives prompts from iOS app via WebSocket subscriptions
  • Executes prompts using tmux send-keys (works even when screen is locked)

Known Limitations

  • macOS only: Requires tmux for terminal integration
  • Gemini CLI version: Hooks require December 2025+ stable release

Features

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

Full feature parity with Claude Code plugin.

License

MIT License - See LICENSE for details.

Support