Hotwired Plugin for Gemini CLI

Gemini CLI extension for Hotwired multi-agent workflow orchestration.

What is Hotwired?

Hotwired coordinates multiple AI coding agents working together on complex tasks. Instead of one agent doing everything, you can have specialized agents (strategist, builder, reviewer) collaborating in real-time with human oversight.

This plugin connects Gemini CLI to the Hotwired desktop app, enabling:

• Workflow coordination - Send messages, handoffs, and status updates between agents
• Human-in-the-loop - Request input, report blockers, get approvals
• Session tracking - Hotwired knows when Gemini is running and in which terminal

Prerequisites

• Hotwired Desktop App - Must be running
• Zellij - Terminal multiplexer for session management
• Gemini CLI - Google's CLI for Gemini
• Node.js - For running the MCP server via npx

Installation

From GitHub

gemini extensions install https://github.com/hotwired-sh/gemini-plugin

Enable Hooks

Add to your ~/.gemini/settings.json:

{
  "hooksConfig": {
    "enabled": true
  }
}

Quick Start

# 1. Start Hotwired desktop app

# 2. Start Gemini in a Zellij session
zellij -s my-project
gemini

# 3. Check connection
/hotwired:status

When Gemini starts, the plugin automatically registers your session with Hotwired.

Available Commands

Command	Description
/hotwired:status	Check connection status and plugin version
/hotwire [intent]	Start a new workflow run
/pair	Join an existing run as second agent

Available Tools

Tool	Description
get_protocol	Fetch workflow protocol and role instructions
get_run_status	Check current run status
report_status	Update your working state
send_message	Send message to other participants
request_input	Ask human for input
report_impediment	Signal you're blocked
handoff	Hand work to another agent
task_complete	Mark a task as complete

Architecture

+------------------------------------------------------------------+
|  HOTWIRED DESKTOP APP                                             |
|  +-- Unix Socket: ~/.hotwired/hotwired.sock                       |
+------------------------------------------------------------------+
                              ^
                              | Local IPC (no network)
                              |
+------------------------------------------------------------------+
|  GEMINI CLI                 |                                     |
|  +----------------------------------------------------+           |
|  |  hotwired-mcp (via npx)                            |           |
|  |  github.com/hotwired-sh/hotwired-mcp               |           |
|  +----------------------------------------------------+           |
|  +----------------------------------------------------+           |
|  |  This Plugin                                       |           |
|  |  - SessionStart hook -> registers session          |           |
|  |  - SessionEnd hook -> deregisters session          |           |
|  |  - /hotwired:status command                        |           |
|  +----------------------------------------------------+           |
+------------------------------------------------------------------+

Everything runs locally. The MCP server communicates with the desktop app via Unix socket. No external network calls.

Troubleshooting

"MCP server not found"

The plugin runs npx @hotwired-sh/hotwired-mcp. Make sure Node.js is installed.

"Not in Zellij session"

Start Gemini inside a Zellij session:

zellij -s my-session
gemini

"Socket not found"

Make sure the Hotwired desktop app is running. It creates the socket at ~/.hotwired/hotwired.sock.

"Hooks not working"

Ensure hooks are enabled in your settings:

{
  "hooksConfig": {
    "enabled": true
  }
}

Related

• hotwired-mcp - The MCP server (open source)
• hotwired.sh - Desktop app and documentation
• Gemini CLI Extensions - Official extension documentation

License

MIT