Getting Started

Installation

Download the latest binary for your platform:

curl -L https://github.com/agent-clis/gripe/releases/latest/download/gripe-$(uname -m)-apple-darwin -o gripe
chmod +x gripe

Or install via Homebrew:

brew install agent-clis/tap/gripe

Initialize

Create a gripe.yaml schema in your repository:

gripe init

This creates a default schema with common fields like tool, summary, severity, and steps.

Submit Your First Issue

gripe submit tool=vim summary="cursor jumps to wrong line on save"

gripe reads your schema, validates the fields, and creates a GitHub issue with the right title, labels, and assignee.

Commands

Command	Description
gripe init	Create a gripe.yaml schema in the current directory
gripe submit	Submit an issue using the active schema
gripe dry-run	Preview what would be submitted without creating an issue

Input Modes

gripe supports four ways to provide field values:

• Inline flags: gripe submit tool=vim summary="bug description"
• Interactive prompts: gripe submit (prompts for each field)
• Piped JSON: echo '{"tool":"vim","summary":"bug"}' | gripe submit
• File input: gripe submit --file issue.json

Authentication

gripe uses the GITHUB_TOKEN environment variable for GitHub API access:

export GITHUB_TOKEN=ghp_your_token_here

The token needs repo scope to create issues.