waffles

command module
v1.0.1 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Jan 19, 2026 License: GPL-3.0 Imports: 1 Imported by: 0

README

Waffles - LLM Toolchain Orchestrator

GitHub go.mod Go version Go Report Card GitHub Actions Workflow Status Docker Pulls GitHub Downloads (all assets, all releases)

Screenshot

Waffles is a command-line tool that orchestrates an LLM toolchain for local development workflows. It automates the process of gathering project context, retrieving prompts, and executing LLM queries, making AI-assisted development more efficient and consistent. Waffles should be pronounced with a Donkey from Shrek accent.

Features

  • Automated Pipeline Orchestration: Seamlessly chains wheresmypromptfiles2promptllm for complete workflow automation
  • Intelligent Repository Analysis: Detects project language, analyzes file structure, and applies smart filtering
  • Dependency Management: Automatic installation and verification of required tools
  • Interactive Setup: Guided configuration wizard for first-time setup
  • Execution History: Persistent logging and querying of all pipeline executions
  • Export Capabilities: Multiple output formats (JSON, CSV, Markdown, SQL) for data analysis
  • Flexible Configuration: Environment-based configuration with per-project overrides

Quick Start

Installation
# Using Homebrew (recommended)
brew install toozej/tap/waffles

# Using Go
go install github.com/toozej/waffles/cmd/waffles@latest

# From source
git clone https://github.com/toozej/waffles.git
cd waffles
make install
First Run Setup
# Interactive setup wizard
waffles setup

# Or setup with auto-installation
waffles setup --auto-install
Basic Usage
# Execute a simple query
waffles query "explain this code structure"

# Query with specific model
waffles query --model gpt-4 "review this code for security issues"

# Export execution history
waffles export --format json --output results.json

Table of Contents

  1. Installation Guide
  2. Usage Guide
  3. Configuration
  4. Commands Reference
  5. Troubleshooting
  6. Examples

Core Workflow

Waffles orchestrates a three-step pipeline:

  1. wheresmyprompt: Retrieves system prompts and context
  2. files2prompt: Extracts relevant project files and context
  3. llm: Executes the LLM query with combined context
graph LR
    A[Query Input] --> B[wheresmyprompt]
    B --> C[files2prompt]
    C --> D[LLM]
    D --> E[Output]
    
    F[Config] --> B
    F --> C
    F --> D
    
    G[Repository Analysis] --> C

Key Benefits

  • Consistency: Standardized workflow ensures consistent results across projects
  • Efficiency: Automated context gathering saves time and reduces errors
  • History: Track all executions with detailed logging and analytics
  • Flexibility: Customizable for different project types and requirements
  • Integration: Works with existing development workflows and tools

Requirements

Required Dependencies
  • wheresmyprompt: System prompt retrieval tool
  • files2prompt: File context extraction tool
  • llm: LLM CLI interface
Optional Dependencies
  • 1Password CLI: For secure credential management (if using 1Password integration)

All dependencies can be automatically installed during setup.

Quick Examples

Basic Query
waffles query "What does this codebase do?"
Custom File Patterns
waffles query --include "*.go,*.md" --exclude "vendor/*" "Analyze the Go code"
Different Models
waffles query --model claude-3-sonnet "Review for performance issues"
waffles query --model gpt-4 "Suggest architectural improvements"
Export Results
# Export as JSON
waffles export --format json --filter "language=go" --output go-queries.json

# Export as CSV for analysis
waffles export --format csv --days 7 --output weekly-usage.csv

Documentation

Support

License

See LICENSE for details.

Contributing

Contributions are welcome! Please see CONTRIBUTING.md for guidelines.

Documentation

The Go Gopher

There is no documentation for this package.

Directories

Path Synopsis
cmd
diagrams command
Package main provides diagram generation utilities for the waffles project.
Package main provides diagram generation utilities for the waffles project.
waffles
Package cmd provides the command-line interface for the waffles LLM toolchain orchestrator.
Package cmd provides the command-line interface for the waffles LLM toolchain orchestrator.
internal
pkg
config
Package config provides secure configuration management for the waffles application.
Package config provides secure configuration management for the waffles application.
man
Package man provides manual page generation functionality for the waffles application.
Package man provides manual page generation functionality for the waffles application.
version
Package version provides build and version information for the waffles application.
Package version provides build and version information for the waffles application.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL