CLI Reference

All commands, flags, and environment variables for the grut command-line interface.

Root Command

grut [flags] [command]

AI-native terminal file explorer, git client, and agent orchestrator. Running grut with no arguments launches the interactive TUI in the current directory.

Global Flags

Key	Action
`--no-ai`	Disable AI features for this operation
`--demo`	Launch with a demo project to explore grüt
`-h, --help`	Show help information
`-v, --version`	Show version information

Environment Variables

Key	Action
`GRUT_LOG`	Path to a log file (enables debug logging)

# Enable debug logging
export GRUT_LOG=/tmp/grut-debug.log
grut

Commands

version

Print the current grüt version.

grut version

update

Update grüt to the latest release. Downloads are SHA-256 verified to ensure integrity.

grut update

mcp

Run grüt as an MCP (Model Context Protocol) server, communicating via stdin/stdout JSON-RPC.

# Standard MCP mode (stdin/stdout)
grut mcp

# TUI + MCP mode (socket transport)
grut mcp --socket

Key	Action
`--socket`	Use socket transport for TUI+MCP mode

run

Execute an AI-powered git workflow shortcut. Shortcuts are predefined sequences of git operations that can be invoked by name.

# Run a shortcut
grut run pr-review

# List available shortcuts
grut run --list

# Describe what a shortcut does
grut run --describe pr-review

# Preview without executing
grut run --dry-run pr-review

# Skip confirmation prompts
grut run --no-confirm pr-review

Key	Action
`--list`	List all available shortcuts
`--describe <name>`	Show what a shortcut does without running it
`--dry-run`	Preview the operations without executing them
`--no-confirm`	Skip confirmation prompts

ext

Manage grüt extensions. Extensions add new panels, commands, and integrations to the TUI.

# Create a new extension scaffold
grut ext create my-extension

# Install an extension
grut ext install my-extension

# Remove an extension
grut ext remove my-extension

# List installed extensions
grut ext list

# Enable / disable an extension
grut ext enable my-extension
grut ext disable my-extension

# Show extension details
grut ext info my-extension

Key	Action
`create`	Scaffold a new extension project
`install`	Install an extension
`remove`	Remove an installed extension
`list`	List all installed extensions
`enable`	Enable a disabled extension
`disable`	Disable an extension without removing it
`info`	Show details about an extension

Examples

# Launch grüt in the current directory
grut

# Launch with AI features disabled
grut --no-ai

# Try grüt with a demo project
grut --demo

# Update to the latest version
grut update

# Use as an MCP server in your AI toolchain
grut mcp --socket