self-command GEMINI.md

Self Command Extension

This extension provides tools that allow the Gemini CLI agent to control its own interface via tmux, wait for tasks, monitor files, and manage the workspace.

Tools

1. self_command

Executes a Gemini CLI command programmatically.

Usage

Use this tool when you need to execute a Gemini CLI command, such as running a specific /command, listing files, or triggering other agent actions.

Tool Signature

self_command({
  command: string; // The command to send to Gemini (e.g., "/compress", "/help").
});

Response Returns a text message confirming the task has started, including a unique Request ID (e.g., [A1B2]). This ID will also appear in the completion notification.

Example

// To ask for help
self_command({ command: "/help" });

CRITICAL INSTRUCTION You MUST yield your turn immediately after calling this tool. Do not attempt to perform other actions.

---

2. gemini_sleep

Sleeps for a specified duration and then sends a wake-up notification.

Usage

Use this tool to pause execution while waiting for a task that you know will take a specific amount of time.

Single Active Sleep Policy: Only ONE sleep task can be active at a time. If you request a new sleep while one is already running, the system will choose the shorter duration:

• If the new sleep ends sooner than the current one, the current sleep is cancelled and replaced by the new, shorter one.
• If the new sleep ends later, the request is ignored, and the existing shorter sleep continues.

Recurring Sleep: You can set recurring: true to be woken up periodically (e.g., for monitoring).

• Constraint: Recurring sleep requires a minimum interval of 3600 seconds (1 hour).

Tool Signature

gemini_sleep({
  seconds: number; // Number of seconds to sleep (or interval if recurring).
  recurring?: boolean; // Optional: If true, wakes repeatedly. Min 3600s.
});

CRITICAL INSTRUCTION You MUST yield your turn immediately after calling this tool.