gemini-tmux-orchestration

Delegate coding tasks to Gemini CLI interactively via tmux sessions.

215|26|Updated Dec 15, 2025
One-click install
npx skills add https://github.com/serejaris/ris-claude-code --skill gemini-tmux-orchestration
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gemini-tmux-orchestration
Source: https://github.com/serejaris/ris-claude-code/tree/main/skills/gemini-tmux-orchestration
Command: npx skills add https://github.com/serejaris/ris-claude-code --skill gemini-tmux-orchestration

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Gemini CLI in headless mode cannot write files or execute shell commands directly; this skill provides a tmux-based workflow to control Gemini interactively from Claude Code, enabling reliable task delegation and parallel execution.

Core Features & Use Cases

  • Status markers and polling to track Gemini state
  • Two-step task sending via tmux to handle Gemini prompts
  • Parallel task orchestration across panes for large workloads
  • Custom .gemini/commands support for reuse

Quick Start

Start Gemini in a split pane and issue commands via tmux, then monitor output.

  • Start Gemini in a split pane: tmux split-window -h -d "cd PROJECT && gemini --yolo"
  • Send a task: tmux send-keys -t {right} 'Build the app per PLAN.md' tmux send-keys -t {right} Enter
  • Check progress: tmux capture-pane -t {right} -p -S -100 | tail -50

Frequently Asked Questions about gemini-tmux-orchestration

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run parallel coding tasks with Gemini CLI and Claude Code?

To run parallel coding tasks with Gemini CLI, you can use tmux to orchestrate interactive sessions. This allows Claude Code to delegate workloads to Gemini split panes, enabling concurrent task execution across large codebases.

Why does Gemini CLI headless mode fail to write files and execute commands?

Gemini CLI headless mode cannot write files or execute shell commands directly due to its execution constraints. A tmux-based workflow solves this by controlling Gemini interactively, enabling reliable task delegation and file manipulation.

Can I use tmux to control Gemini CLI for interactive code automation?

Yes, you can use tmux to control Gemini CLI for interactive code automation. By starting Gemini in a split pane and sending inputs via tmux commands, you can manage state, poll outputs, and automate complex coding workflows.

Do I need tmux installed to delegate tasks to Gemini from Claude Code?

Yes, you need tmux installed to delegate tasks to Gemini from Claude Code. The workflow requires Claude Code running inside a tmux session to manage panes, send inputs, and capture outputs from the Gemini CLI.

What is the best way to manage large codebases with Gemini's 1M context window?

The best way to manage large codebases with Gemini's 1M context window is through parallel task orchestration across multiple tmux panes. This approach distributes complex workloads, allowing concurrent processing and interactive control.

How do I send a task to a Gemini pane using tmux?

To send a task to a Gemini pane using tmux, use the send-keys command targeting the right pane, enter your prompt string, and press Enter. You can then check progress by capturing the pane output.