Gemini Workspaces Skill

This skill enables the agent to utilize Gemini Workspaces—a high-performance, persistent remote development platform. It allows the agent to move intensive tasks (PR reviews, complex repairs, full builds) from the local environment to a dedicated cloud worker.

🛠️ Key Capabilities

Persistent Execution: Jobs run in remote tmux sessions. Disconnecting or crashing the local terminal does not stop the remote work.
Parallel Infrastructure: The agent can launch a heavy task (like a full build or CI run) in a workspace while continuing to assist the user locally.
Behavioral Fidelity: Remote workers have full tool access (Git, Node, Docker, etc.) and high-performance compute, allowing the agent to provide behavioral proofs of its work.

📋 Instructions for the Agent

When to use Workspaces

Intensive Tasks: Full preflight runs, large-scale refactors, or deep PR reviews.
Persistent Logic: When a task is expected to take longer than a few minutes and needs to survive local connection drops.
Environment Isolation: When you need a clean, high-performance environment to verify a fix without polluting the user's local machine.

How to use Workspaces

Setup: If the user hasn't initialized their environment, instruct them to run npm run workspace:setup.
Launch: Use the workspace command to start a playbook:
```
npm run workspace <PR_NUMBER> [action]
```
- Actions: review (default), fix, ready.
Check Status: Poll the progress using npm run workspace:check <PR_NUMBER> or see the global state with npm run workspace:status.

⚠️ Important Constraints

Absolute Paths: Always use absolute paths (e.g., /home/node/...) when orchestrating remote commands.
Be Behavioral: Prioritize results from live execution (behavioral proofs) over static reading.
Multi-tasking: Remind the user they can continue chatting in the main window while the heavy workspace task runs in the separate terminal window.

2.0 KiB Raw Blame History