gru-guide

Guide users through installing, configuring, and troubleshooting Gru for GitHub issues.

11|Updated Dec 1, 2025
One-click install
npx skills add https://github.com/fotoetienne/gru --skill gru-guide
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gru-guide
Source: https://github.com/fotoetienne/gru/tree/main/.claude/skills/gru-guide
Command: npx skills add https://github.com/fotoetienne/gru --skill gru-guide

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides an interactive guide to install, configure, troubleshoot, and understand Gru commands and concepts, streamlining the user experience.

Core Features & Use Cases

  • Onboarding: Walks users through the setup process, including prerequisites, installation, and initial usage.
  • Command Reference: Explains Gru commands with examples, including gru init, gru do, and gru status.
  • Config Help: Reads and explains the user's configuration file, providing guidance on settings and customization.
  • Concept Explanations: Delivers clear explanations of Gru concepts like Minions, worktrees, labels, and lab mode.
  • Troubleshooting: Diagnoses errors and suggests fixes for common issues.

Quick Start

Use the Gru guide skill to get started with Gru by asking, "How do I set up Gru?"

Frequently Asked Questions about gru-guide

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

FAQPage Schema
How do I set up a local-first AI coding agent for GitHub issues?

To set up a local-first AI coding agent for GitHub issues, you need to install and configure Gru. This guide walks you through the prerequisites, installation, and initial usage commands like `gru init` to orchestrate your workflow seamlessly.

What are Minions and worktrees in Gru?

Minions and worktrees are core concepts in Gru. Minions act as the local-first LLM agents executing tasks, while worktrees manage isolated Git branches, enabling parallel issue resolution without disrupting your main codebase.

Why is my Gru AI agent not processing GitHub issues correctly?

If your Gru AI agent is not processing GitHub issues correctly, you likely have a configuration error. This guide diagnoses common setup issues, reads your configuration file, and suggests fixes to restore local-first orchestration.

How do I use the gru do and gru status commands?

You use `gru do` to dispatch tasks to your local-first AI agent for GitHub issues, and `gru status` to track their progress. This guide provides interactive command references with examples for effective issue management.

Can I customize the configuration settings for my local-first LLM orchestrator?

You can customize configuration settings for your local-first LLM orchestrator by modifying the Gru config file. This guide reads your existing configuration, explains available settings, and provides guidance on tailoring the agent to your environment.