@quantiya/codevibe-gemini-plugin 1.0.0

package/.env.example

@@ -0,0 +1,28 @@
+# Gemini Companion Plugin Configuration
+# ======================================
+# NOTE: You typically don't need to edit this file manually.
+# Configuration is auto-set after running 'codevibe-gemini login'.
+#
+# Copy this file to .env.production or .env.development and fill in values.
+
+# Server Configuration
+PORT=3456
+HOST=localhost
+
+# AWS Configuration
+# These values are provided by the CodeVibe service
+AWS_REGION=us-east-1
+APPSYNC_URL=https://your-appsync-endpoint.appsync-api.us-east-1.amazonaws.com/graphql
+
+# Cognito Configuration (for OAuth authentication)
+COGNITO_USER_POOL_ID=us-east-1_xxxxxxxxx
+COGNITO_CLIENT_ID=xxxxxxxxxxxxxxxxxxxxxxxxxx
+COGNITO_DOMAIN=your-domain.auth.us-east-1.amazoncognito.com
+
+# Gemini Configuration
+GEMINI_COMMAND=gemini
+GEMINI_TIMEOUT=60000
+
+# Logging Configuration
+LOG_FILE=/tmp/codevibe-gemini-mcp.log
+LOG_LEVEL=info

package/README.md

@@ -0,0 +1,117 @@
+# 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 tmux integration)
+- **Node.js 18+**
+- **tmux** (`brew install tmux`)
+- **Gemini CLI** installed and authenticated
+- **CodeVibe iOS app** installed on your iPhone
+
+## Installation
+
+```bash
+npm install -g codevibe-gemini-plugin
+```
+
+### From Source (Development)
+
+```bash
+git clone https://github.com/hendryyeh/quantiya-codevibe-gemini-plugin.git
+cd quantiya-codevibe-gemini-plugin
+npm install
+npm run build
+```
+
+## Usage
+
+### First Time Setup
+
+```bash
+# Authenticate with backend (opens browser for Sign in with Apple/Google)
+codevibe-gemini login
+
+# Check authentication status
+codevibe-gemini status
+```
+
+### Running the Plugin
+
+```bash
+# Start Gemini with mobile sync
+codevibe-gemini
+```
+
+The plugin will automatically detect Gemini sessions and sync conversations to your iOS app.
+
+### CLI Commands
+
+| 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
+
+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.**
+
+## Related
+
+- **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
+
+## 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

package/bin/codevibe-gemini

@@ -0,0 +1,238 @@
+#!/bin/bash
+#
+# codevibe-gemini - Wrapper to run Gemini CLI inside tmux for mobile control
+#
+# This script launches Gemini CLI inside a tmux session, enabling:
+# - Mobile prompts when screen is locked (via tmux send-keys)
+# - Same user experience as regular gemini command
+# - Automatic sync with iOS app via MCP server
+#
+# Usage:
+#   codevibe-gemini [gemini-args...]
+#   codevibe-gemini login              # Sign in via browser
+#   codevibe-gemini logout             # Sign out
+#   codevibe-gemini status             # Show auth status
+#
+# Environment:
+#   ENVIRONMENT                         # Set to 'production' (default) or 'development'
+#
+# Examples:
+#   codevibe-gemini                    # Start new session
+#   codevibe-gemini --resume           # Resume last session
+#   codevibe-gemini "fix the bug"      # Start with prompt
+#   ENVIRONMENT=development codevibe-gemini login  # Login to development
+#
+
+set -e
+
+# Default to production environment if not specified
+# Users can set ENVIRONMENT=development for local development
+export ENVIRONMENT="${ENVIRONMENT:-production}"
+
+# Use TMPDIR if set (macOS sets this to user-specific temp), otherwise /tmp
+CODEVIBE_TMPDIR="${TMPDIR:-/tmp}"
+
+# Get the directory where this script is located (resolving symlinks)
+# This is needed because npm global installs symlink bin scripts to /usr/local/bin/
+SOURCE="${BASH_SOURCE[0]}"
+while [ -L "$SOURCE" ]; do
+  DIR="$(cd -P "$(dirname "$SOURCE")" && pwd)"
+  SOURCE="$(readlink "$SOURCE")"
+  [[ $SOURCE != /* ]] && SOURCE="$DIR/$SOURCE"
+done
+SCRIPT_DIR="$(cd -P "$(dirname "$SOURCE")" && pwd)"
+PLUGIN_DIR="$(dirname "$SCRIPT_DIR")"
+
+# Handle auth commands (login, logout, status, reset-device)
+# Delegate to codevibe-core CLI (shared auth across all plugins)
+case "$1" in
+    login|logout|status|reset-device)
+        CORE_CLI="$PLUGIN_DIR/node_modules/@quantiya/codevibe-core/bin/codevibe.js"
+        if [ -f "$CORE_CLI" ]; then
+            exec node "$CORE_CLI" "$1"
+        else
+            echo "Error: codevibe-core not found. Run 'npm install' in the plugin directory first."
+            exit 1
+        fi
+        ;;
+esac
+
+# Export hooks directory for hook scripts to use
+export CODEVIBE_HOOKS_DIR="$PLUGIN_DIR/hooks"
+
+# Auto-configure hooks on startup if not already configured
+configure_hooks_if_needed() {
+    GEMINI_SETTINGS_DIR="$HOME/.gemini"
+    GEMINI_SETTINGS_FILE="$GEMINI_SETTINGS_DIR/settings.json"
+    HOOKS_DIR="$PLUGIN_DIR/hooks"
+    TEMPLATE_FILE="$PLUGIN_DIR/gemini-hooks-settings.json"
+
+    # Make hook scripts executable
+    chmod +x "$HOOKS_DIR"/*.sh 2>/dev/null || true
+
+    # Create .gemini directory if it doesn't exist
+    mkdir -p "$GEMINI_SETTINGS_DIR"
+
+    # Check if hooks need to be configured
+    if [ ! -f "$GEMINI_SETTINGS_FILE" ]; then
+        # No settings file - create it with hooks
+        echo "Configuring Gemini CLI hooks for CodeVibe..."
+        sed "s|__CODEVIBE_HOOKS_DIR__|$HOOKS_DIR|g" "$TEMPLATE_FILE" > "$GEMINI_SETTINGS_FILE"
+        echo "✓ Hooks configured at: $GEMINI_SETTINGS_FILE"
+    elif ! grep -q "BeforeAgent" "$GEMINI_SETTINGS_FILE" 2>/dev/null; then
+        # Settings file exists but missing agent hooks - warn user to upgrade
+        echo "⚠ Gemini CLI hooks need updating. BeforeAgent/AfterAgent hooks required."
+        echo "  Update hooks in: $GEMINI_SETTINGS_FILE"
+        echo "  Or delete the file and restart to auto-configure."
+        echo ""
+    elif ! grep -q "BeforeTool" "$GEMINI_SETTINGS_FILE" 2>/dev/null; then
+        # Settings file exists but no tool hooks - warn user
+        echo "⚠ Gemini CLI hooks not fully configured."
+        echo "  To enable interactive prompts from mobile, add hooks to:"
+        echo "  $GEMINI_SETTINGS_FILE"
+        echo ""
+    fi
+}
+
+# Configure hooks before starting
+configure_hooks_if_needed
+
+# Configuration
+TMUX_SESSION_PREFIX="codevibe-gemini"
+LOG_FILE="${CODEVIBE_TMPDIR}/codevibe-gemini-wrapper.log"
+MCP_LOG_FILE="${CODEVIBE_TMPDIR}/codevibe-gemini-mcp.log"
+
+log() {
+    echo "[$(date '+%Y-%m-%d %H:%M:%S')] $*" >> "$LOG_FILE"
+}
+
+# Cleanup function to kill MCP server when wrapper exits
+cleanup() {
+    log "Cleanup triggered"
+    if [ -n "$MCP_PID" ] && kill -0 "$MCP_PID" 2>/dev/null; then
+        log "Stopping MCP server (PID: $MCP_PID)"
+        kill "$MCP_PID" 2>/dev/null || true
+        wait "$MCP_PID" 2>/dev/null || true
+    fi
+    # Remove PID file
+    rm -f "${CODEVIBE_TMPDIR}/codevibe-gemini-mcp-$$.pid"
+}
+
+# Set up trap for cleanup
+trap cleanup EXIT INT TERM
+
+# Check if tmux is installed
+if ! command -v tmux &> /dev/null; then
+    echo "Error: tmux is required but not installed."
+    echo "Install with: brew install tmux"
+    exit 1
+fi
+
+# Check if gemini is installed
+if ! command -v gemini &> /dev/null; then
+    echo "Error: gemini CLI is not installed."
+    echo "Install from: https://github.com/google-gemini/gemini-cli"
+    exit 1
+fi
+
+# Check if node is installed
+if ! command -v node &> /dev/null; then
+    echo "Error: Node.js is required but not installed."
+    exit 1
+fi
+
+# Check if MCP server is built
+if [ ! -f "$PLUGIN_DIR/dist/server.js" ]; then
+    echo "Error: MCP server not built. Run 'npm run build' in the plugin directory first."
+    exit 1
+fi
+
+# Generate a unique session name
+SESSION_NAME="${TMUX_SESSION_PREFIX}-$$"
+WORKING_DIR="$(pwd)"
+
+log "Starting codevibe-gemini with session: $SESSION_NAME"
+log "Working directory: $WORKING_DIR"
+log "Arguments: $*"
+
+# Check if we're already inside tmux
+if [ -n "$TMUX" ]; then
+    log "Already inside tmux, running gemini directly"
+    # Already in tmux, just run gemini
+    exec gemini "$@"
+fi
+
+# Check if running in a terminal
+if [ ! -t 0 ] || [ ! -t 1 ]; then
+    log "Not running in a terminal, running gemini directly"
+    exec gemini "$@"
+fi
+
+# Start MCP server in background BEFORE launching Gemini
+# The MCP server will watch the transcript file for changes
+log "Starting MCP server..."
+export GEMINI_WORKING_DIRECTORY="$WORKING_DIR"
+export CODEVIBE_GEMINI_TMUX_SESSION="$SESSION_NAME"
+
+# Start MCP server and capture its PID
+node "$PLUGIN_DIR/dist/server.js" >> "$MCP_LOG_FILE" 2>&1 &
+MCP_PID=$!
+echo "$MCP_PID" > "${CODEVIBE_TMPDIR}/codevibe-gemini-mcp-$$.pid"
+
+log "MCP server started with PID: $MCP_PID"
+
+# Wait a moment for MCP server to initialize
+sleep 1
+
+# Check if MCP server is still running (exits if auth failed)
+if ! kill -0 "$MCP_PID" 2>/dev/null; then
+    log "ERROR: MCP server failed to start"
+    # Show the last few lines of the log for context (e.g., auth error)
+    echo ""
+    tail -3 "$MCP_LOG_FILE" 2>/dev/null | grep -v '^\[' | head -1
+    echo ""
+    echo "Server failed to start. Check $MCP_LOG_FILE for details."
+    exit 1
+fi
+
+# Create tmux session and run gemini
+log "Creating tmux session: $SESSION_NAME"
+
+# Build the gemini command with proper escaping
+GEMINI_CMD="gemini"
+for arg in "$@"; do
+    # Escape single quotes in arguments
+    escaped_arg=$(printf '%s' "$arg" | sed "s/'/'\\\\''/g")
+    GEMINI_CMD="$GEMINI_CMD '$escaped_arg'"
+done
+
+# Create the session running gemini, then attach
+# We use a wrapper that:
+# 1. Exports the session name so prompts can find it
+# 2. Runs gemini
+# 3. Exits the tmux session when gemini exits
+
+tmux new-session -d -s "$SESSION_NAME" -x "$(tput cols)" -y "$(tput lines)" \
+    "export CODEVIBE_GEMINI_TMUX_SESSION='$SESSION_NAME'; export ENVIRONMENT='$ENVIRONMENT'; $GEMINI_CMD; exit"
+
+# Enable mouse support for scrolling
+tmux set-option -t "$SESSION_NAME" -g mouse on
+
+# Enable copy/paste with system clipboard (macOS)
+tmux set-option -t "$SESSION_NAME" set-clipboard on
+tmux set-window-option -t "$SESSION_NAME" mode-keys vi
+tmux bind-key -T copy-mode-vi y send-keys -X copy-pipe-and-cancel "pbcopy"
+tmux bind-key -T copy-mode-vi MouseDragEnd1Pane send-keys -X copy-pipe-and-cancel "pbcopy"
+
+# Store session mapping for mobile prompts
+echo "$SESSION_NAME" > "${CODEVIBE_TMPDIR}/codevibe-gemini-tmux-session-$$"
+
+log "Attaching to tmux session: $SESSION_NAME"
+
+# Attach to the session
+# This will show gemini's UI to the user
+# When tmux session exits, the trap will clean up the MCP server
+tmux attach-session -t "$SESSION_NAME"
+
+# After tmux exits, cleanup is handled by trap
+log "Tmux session ended"

package/dist/appsync-client.d.ts

@@ -0,0 +1,66 @@
+import { CreateEventInput, CreateSessionInput, UpdateSessionInput, UpdateEventStatusInput, CreateFileChangeInput, Event, Session, EventSource, DownloadUrlResponse } from './types';
+export declare class AppSyncClient {
+    private authenticated;
+    private currentUserId;
+    private currentEmail;
+    private storedTokens;
+    private activeSubscriptions;
+    constructor();
+    getCurrentUserId(): string;
+    getCurrentUserEmail(): string | null;
+    /**
+     * Authenticate using stored OAuth tokens from 'codevibe-gemini login'
+     * Returns true if successfully authenticated, false otherwise
+     */
+    authenticateWithStoredTokens(): Promise<boolean>;
+    /**
+     * Refresh expired tokens using the refresh token
+     */
+    private refreshStoredTokens;
+    /**
+     * Check if stored tokens exist and are valid
+     */
+    hasValidStoredTokens(): boolean;
+    signOutUser(): void;
+    /**
+     * Make a direct GraphQL request to AppSync using fetch
+     * Uses stored OAuth tokens for Cognito User Pool authentication
+     * Automatically refreshes token and retries on 401 errors
+     */
+    private graphqlRequest;
+    createSession(input: CreateSessionInput): Promise<Session>;
+    updateSession(input: UpdateSessionInput): Promise<Session>;
+    createEvent(input: CreateEventInput): Promise<Event>;
+    updateEventStatus(input: UpdateEventStatusInput): Promise<Event>;
+    createFileChange(input: CreateFileChangeInput): Promise<any>;
+    getSession(sessionId: string): Promise<Session | null>;
+    listEvents(sessionId: string, source?: EventSource): Promise<Event[]>;
+    subscribeToEvents(sessionId: string, onEvent: (event: Event) => void, onError?: (error: Error) => void): () => void;
+    /**
+     * Build the AppSync real-time WebSocket URL with authorization
+     */
+    private buildRealtimeUrl;
+    /**
+     * Create a custom WebSocket subscription to AppSync
+     * This bypasses Amplify which doesn't work with externally stored tokens
+     */
+    private createSubscription;
+    /**
+     * Send subscription start message
+     */
+    private sendSubscriptionStart;
+    /**
+     * Reset the keep-alive timer - if no message received in 5 minutes, reconnect
+     */
+    private resetKeepAliveTimer;
+    private handleSubscriptionError;
+    private cleanupSubscriptionState;
+    cleanupSubscriptions(): void;
+    getAttachmentDownloadUrl(s3Key: string): Promise<DownloadUrlResponse>;
+    listUserDeviceKeys(): Promise<Array<{
+        deviceId: string;
+        publicKey: string;
+    }>>;
+    isAuthenticated(): boolean;
+}
+//# sourceMappingURL=appsync-client.d.ts.map

package/dist/appsync-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"appsync-client.d.ts","sourceRoot":"","sources":["../src/appsync-client.ts"],"names":[],"mappings":"AAUA,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,sBAAsB,EACtB,qBAAqB,EACrB,KAAK,EACL,OAAO,EACP,WAAW,EAEX,mBAAmB,EACpB,MAAM,SAAS,CAAC;AAqLjB,qBAAa,aAAa;IACxB,OAAO,CAAC,aAAa,CAAkB;IACvC,OAAO,CAAC,aAAa,CAAuB;IAC5C,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,mBAAmB,CAA6C;;IAOjE,gBAAgB,IAAI,MAAM;IAK1B,mBAAmB,IAAI,MAAM,GAAG,IAAI;IAI3C;;;OAGG;IACU,4BAA4B,IAAI,OAAO,CAAC,OAAO,CAAC;IA2C7D;;OAEG;YACW,mBAAmB;IAoDjC;;OAEG;IACI,oBAAoB,IAAI,OAAO;IAM/B,WAAW,IAAI,IAAI;IAQ1B;;;;OAIG;YACW,cAAc;IAqDf,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC;IA8B1D,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC;IAsB1D,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,KAAK,CAAC;IA8BpD,iBAAiB,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,KAAK,CAAC;IAuBhE,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,GAAG,CAAC;IA6B5D,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IActD,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAc3E,iBAAiB,CACtB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,EAC/B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAC/B,MAAM,IAAI;IAoCb;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAuBxB;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IA+H1B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA8B7B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAa3B,OAAO,CAAC,uBAAuB;IAoE/B,OAAO,CAAC,wBAAwB;IAgCzB,oBAAoB,IAAI,IAAI;IActB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAmBrE,kBAAkB,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAqBnF,eAAe,IAAI,OAAO;CAGlC"}