go-aha¶

A Go SDK and CLI for the Aha! Roadmap API.

Features¶

Full API Coverage - Generated client from OpenAPI specification
CLI Tool - Command-line interface for common operations
Report Generation - Create idea-feature-release reports with XLSX/Markdown export
Helper Libraries - High-level functions for common workflows

Quick Example¶

CLI¶

# List ideas
aha ideas list --per-page 10

# Generate a report of all ideas with their features and releases
aha report idea-feature --all -f xlsx -o ideas_report.xlsx

SDK¶

package main

import (
    "context"
    "fmt"

    "github.com/grokify/go-aha/v3/oag7/aha"
    "github.com/grokify/go-aha/v3/oag7/client"
    "github.com/grokify/go-aha/v3/oag7/ideas"
)

func main() {
    cfg, _ := client.NewConfiguration("your-domain", "your-api-key")
    apiClient := aha.NewAPIClient(cfg)

    // Generate a comprehensive report
    req := ideas.ListIdeasRequest{FetchAll: true}
    reportSet, _ := ideas.GetIdeaFeatureReports(context.Background(), apiClient, req)

    // Export to XLSX
    reportSet.Table().WriteXLSX("report.xlsx", "Ideas")
}

Installation¶

go install github.com/grokify/go-aha/v3/cmd/aha@latest

Documentation¶

Getting Started - Installation and configuration
CLI Reference - Command-line interface documentation
SDK Guide - Using the Go SDK in your applications
Examples - Common usage patterns

License¶

MIT License - see LICENSE for details.