# Install go-invoice
go install github.com/mrz1836/go-invoice/cmd/go-invoice@latest

# Initialize storage and set up your business configuration
go-invoice init
go-invoice config setup

# Add your first client
go-invoice client create --name "Acme Corp" --email "billing@acme.com" --phone "+1-555-0123"

# Import timesheet data (CSV or JSON) and create invoice
go-invoice import create timesheet.csv --client "Acme Corp" --description "August 2025 Services"
# OR for JSON:
go-invoice import create timesheet.json --client "Acme Corp" --description "August 2025 Services"

# Generate HTML from the invoice
go-invoice generate invoice <invoice-id> --output invoice.html

# View your invoice in the browser
open invoice.html

# Run the setup command
go-invoice config setup-claude --desktop

# Or manually add to Claude Desktop config:
# ~/.config/claude-desktop/mcp_servers.json
{
  "mcpServers": {
    "go-invoice": {
      "command": "/path/to/go-invoice-mcp",
      "args": ["--transport", "http", "--port", "8080"],
      "env": {
        "DATA_DIR": "/path/to/your/invoice/data"
      }
    }
  }
}

# Setup for current project
go-invoice config setup-claude --code

# Or manually create .mcp.json:
{
  "mcpServers": {
    "go-invoice": {
      "command": "/path/to/go-invoice-mcp",
      "args": ["--stdio"],
      "env": {
        "GO_INVOICE_HOME": "${HOME}/.go-invoice"
      }
    }
  }
}

# Verify installation
go-invoice-mcp --version

# Test MCP server directly
go-invoice-mcp --transport stdio --test

# Check Claude Desktop logs
tail -f ~/.config/claude-desktop/logs/mcp.log

# Test HTTP transport
curl http://localhost:8080/mcp -d '{"jsonrpc":"2.0","method":"ping","id":"test"}'

# Verify business configuration
go-invoice config show

# Test tool discovery
go-invoice-mcp --transport stdio --list-tools

# Clone the repository
git clone https://github.com/mrz1836/go-invoice.git
cd go-invoice

# Build the application
magex devBuild

go install github.com/mrz1836/go-invoice@latest

go-invoice --version

# 1. Create a client with crypto service fee enabled
go-invoice client create \
  --name "Acme Company" \
  --email "billing@example.com" \
  --crypto-fee \
  --crypto-fee-amount 25.00

# 2. Create invoice for this client - fee is automatically applied
go-invoice invoice create \
  --client "Acme Company" \
  --description "Q1 2025 Consulting Services"

# 3. Generate HTML - the $25 crypto fee will be included
go-invoice generate invoice INV-2025-001

# In your .env.config file
USDC_ENABLED=true
USDC_ADDRESS="0xYourUSDCWalletAddress"
# OR
BSV_ENABLED=true
BSV_ADDRESS="YourBSVWalletAddress"

go-invoice client update "Acme Company" \
  --crypto-fee \
  --crypto-fee-amount 25.00

# Override USDC address for this specific invoice
go-invoice invoice create \
  --client "Acme Corp" \
  --usdc-address "0xCustomUSDCAddressForThisInvoice123"

# Override both USDC and BSV addresses
go-invoice invoice create \
  --client "Tech Solutions" \
  --usdc-address "0xCustomUSDCAddress123" \
  --bsv-address "CustomBSVAddress123"

# Works with all other flags
go-invoice invoice create \
  --client "New Client" \
  --description "January 2025 services" \
  --usdc-address "0xUniqueAddress123"

# Add or change USDC address on existing invoice
go-invoice invoice update INV-001 \
  --usdc-address "0xNewUSDCAddress456"

# Clear the override (will use global config address)
go-invoice invoice update INV-001 \
  --clear-usdc-address

# Update both addresses
go-invoice invoice update INV-001 \
  --usdc-address "0xNewUSDCAddress" \
  --bsv-address "NewBSVAddress"

# 1. Set global crypto addresses in config
export USDC_ENABLED=true
export USDC_ADDRESS="0xYourDefaultUSDCAddress"
export BSV_ENABLED=true
export BSV_ADDRESS="YourDefaultBSVAddress"

# 2. Create invoice with global addresses (default behavior)
go-invoice invoice create --client "Regular Client"

# 3. Create invoice with custom address for special tracking
go-invoice invoice create \
  --client "Premium Client" \
  --usdc-address "0xPremiumClientUniqueAddress"

# 4. Later, update an invoice to use a different address
go-invoice invoice update INV-002 \
  --usdc-address "0xUpdatedAddress"

# 5. Clear override to go back to global address
go-invoice invoice update INV-002 \
  --clear-usdc-address

go-invoice config setup

# Environment variables
export BUSINESS_NAME="Your Business Name"
export BUSINESS_EMAIL="billing@yourbusiness.com"
export BUSINESS_ADDRESS="123 Business St, City, State 12345"
export PAYMENT_TERMS="Net 30"
export CURRENCY="USD"
export VAT_RATE="0.10"  # 10% tax rate

# Business Information
BUSINESS_NAME=Your Business Name
BUSINESS_ADDRESS=123 Business St\nCity, State 12345
BUSINESS_EMAIL=billing@yourbusiness.com
BUSINESS_PHONE=+1-555-0123
BUSINESS_WEBSITE=yourbusiness.com
PAYMENT_TERMS=Net-30

# Invoice Settings
INVOICE_PREFIX=INV
INVOICE_START_NUMBER=1000
INVOICE_DUE_DAYS=30  # Auto-calculates due dates
CURRENCY=USD

# Tax Settings
TAX_RATE=0.10  # 10% tax
TAX_ENABLED=true

# Payment Methods
ACH_ENABLED=true
USDC_ENABLED=false
USDC_ADDRESS="0xYourUSDCWalletAddress"
BSV_ENABLED=false
BSV_ADDRESS="YourBSVWalletAddress"

# Storage Settings
DATA_DIR=./data
AUTO_BACKUP=true

# Add a new client with all details
go-invoice client create \
  --name "Acme Corporation" \
  --email "billing@acme.com" \
  --address "456 Client Ave, Client City, CC 67890" \
  --phone "+1-555-0199" \
  --tax-id "EIN-12-3456789" \
  --approver-contacts "John Doe, Finance Dept"

# List all clients with optional filters
go-invoice client list
go-invoice client list --active-only --name-search "Acme"

# View client details and invoice history
go-invoice client show --client "Acme Corporation" --include-invoices

# Update client information
go-invoice client update --client "Acme Corporation" --email "newbilling@acme.com"

# Deactivate a client (soft delete preserves data)
go-invoice client delete --client "Acme Corporation" --soft-delete

# Create a new invoice with optional work items
go-invoice invoice create \
  --client "Acme Corporation" \
  --description "August 2025 Development Services" \
  --date 2025-08-07  # Due date auto-calculated based on net terms

# Add work items to existing invoice
go-invoice invoice add-item \
  INV-2025-001 \
  --description "Frontend development" \
  --hours 8.5 \
  --rate 125.00 \
  --date 2025-08-01

# List all invoices with filters
go-invoice invoice list
go-invoice invoice list --status sent --from-date 2025-08-01
go-invoice invoice list --client "Acme" --include-summary

# Update invoice (including date which auto-updates due date)
go-invoice invoice update INV-2025-001 --date 2025-08-07
go-invoice invoice update INV-2025-001 --status sent
go-invoice invoice update INV-2025-001 --status paid

# Recalculate invoice totals (useful after data migration or bug fixes)
go-invoice invoice recalculate INV-2025-001

# Generate HTML invoice
go-invoice generate invoice INV-2025-001 --output invoice-august.html
go-invoice generate invoice INV-2025-001 --template professional --open

# Send all draft invoices
go-invoice invoice send --all-drafts

# Generate overdue report
go-invoice report overdue --format html --output overdue-report.html

# Export invoice data
go-invoice export invoices --format json --output invoices-backup.json

# Import timesheet (auto-detects CSV or JSON format) and create new invoice
go-invoice import create timesheet.csv \
  --client "Acme Corporation" \
  --description "August 2025 Services" \
  --date 2025-08-07

# Import JSON data with same command (format auto-detected)
go-invoice import create timesheet.json \
  --client "Acme Corporation" \
  --description "August 2025 Services"

# Append data to existing invoice (CSV or JSON)
go-invoice import append timesheet.csv \
  INV-2025-001 \
  --skip-duplicates

# Preview import before executing
go-invoice import preview timesheet.csv \
  --client "Acme Corporation" \
  --show-totals --show-warnings

# Validate format before importing
go-invoice import validate timesheet.json

# Import with custom configuration
go-invoice import create timesheet.csv \
  --client "Acme Corporation" \
  --default-rate 125.00 \
  --description "Monthly development work" \
  --currency USD \
  --due-days 30

# Generate HTML invoice with default template
go-invoice generate invoice INV-2025-001 \
  --output invoice.html

# Generate with professional template
go-invoice generate invoice INV-2025-001 \
  --template professional \
  --output invoice.html \
  --open  # Open in browser after generation

# Preview invoice generation without saving
go-invoice generate preview INV-2025-001

# List available templates
go-invoice generate templates

# Run performance benchmarks
magex bench

# Sample results:
BenchmarkSimpleServerOperations/ping_request-10         1486044    860.1 ns/op    1034 B/op    9 allocs/op
BenchmarkSimpleServerOperations/initialize_request-10   1494889    805.4 ns/op    1008 B/op   10 allocs/op
BenchmarkBasicTransportOperations/transport_health_check-10  9636212    112.7 ns/op
BenchmarkResponseTimeValidation/response_time_under_target-10  1480423    884.0 ns/op

# Run linting
magex lint

# Run all tests
magex test

# Run tests with race detection
magex test:race

# Run integration tests
go test -v -run TestIntegrationSuite

# Generate test coverage
magex test:cover

# Build main application only
magex buildMain

# Build MCP server only
magex buildMCP

# Build both applications (default target)
magex buildAll

# Build development version with "dev" tag
magex devBuild

# Build development versions of both binaries
magex devBuildAll

# Install main binary to $GOPATH/bin
magex installMain

# Install MCP server to $GOPATH/bin
magex installMCP

# Install both binaries to $GOPATH/bin
magex installAll

# Clean build artifacts
magex clean

# Clean all artifacts and installed binaries
magex cleanAll

# Run performance benchmarks
magex bench

# Run all tests (fast)
magex test

# Run tests with race detection (slower but thorough)
magex test:race

# Run integration tests only
go test -v -run TestIntegrationSuite

# Run tests with coverage report
magex test:cover

# Run benchmarks
magex bench

# Generate HTML coverage report
go test -coverprofile=coverage.out ./...
go tool cover -html=coverage.out -o coverage.html

# 1. Initialize and configure go-invoice
go-invoice init
go-invoice config setup  # Interactive setup wizard

# Or create a .env.config file:
cat > .env.config << EOF
BUSINESS_NAME="Freelance Developer"
BUSINESS_EMAIL="billing@freelancer.dev"
BUSINESS_WEBSITE="freelancer.dev"
BUSINESS_PHONE="+1-555-0123"
PAYMENT_TERMS="Net-30"
CURRENCY="USD"
TAX_RATE="0.08"
TAX_ENABLED="true"
INVOICE_DUE_DAYS="30"  # Auto-calculates due dates

# Optional: Enable cryptocurrency payments
USDC_ENABLED="true"
USDC_ADDRESS="0xYourUSDCWalletAddress"
BSV_ENABLED="false"
BSV_ADDRESS=""
EOF

# 2. Add a client with full details
go-invoice client create \
  --name "TechCorp Solutions" \
  --email "accounting@techcorp.com" \
  --address "789 Tech Blvd, Innovation City, IC 54321" \
  --phone "+1-555-9876" \
  --approver-contacts "Jane Smith, CFO" \
  --tax-id "EIN-98-7654321"

# 3. Create timesheet data (CSV or JSON)
# CSV format:
cat > january-timesheet.csv << EOF
date,description,hours,rate
2025-01-15,Frontend development and UI design,8.5,125.00
2025-01-16,Backend API implementation,7.25,135.00
2025-01-17,Code review and documentation,3.0,100.00
EOF

# JSON format (alternative):
cat > january-timesheet.json << EOF
[
  {"date": "2025-01-15", "description": "Frontend development", "hours": 8.5, "rate": 125.00},
  {"date": "2025-01-16", "description": "Backend API", "hours": 7.25, "rate": 135.00}
]
EOF

# 4. Import and create invoice (format auto-detected)
INVOICE_NUMBER=$(go-invoice import create january-timesheet.csv \
  --client "TechCorp Solutions" \
  --description "January 2025 Development Services" \
  --date 2025-01-31 \
  --output json | jq -r '.number')

echo "Created invoice: $INVOICE_NUMBER"
# Output: Created invoice: INV-2025-001

# 5. Generate professional HTML invoice (with comma-separated currency)
go-invoice generate invoice $INVOICE_NUMBER \
  --output january-invoice.html \
  --template professional

# 6. Update invoice date (auto-updates due date to 30 days later)
go-invoice invoice update $INVOICE_NUMBER --date 2025-02-01
# Due date automatically becomes 2025-03-03

# 7. Mark invoice as sent
go-invoice invoice update $INVOICE_NUMBER --status sent

# 8. View invoice details
go-invoice invoice show $INVOICE_NUMBER

# 9. Later, mark as paid
go-invoice invoice update $INVOICE_NUMBER --status paid

# 10. List all invoices for the month (as a summary)
go-invoice invoice list \
  --from-date 2025-01-01 \
  --to-date 2025-01-31 \
  --include-summary

#!/bin/bash
# Monthly invoice automation script

CLIENT="TechCorp Solutions"
MONTH=$(date +%B-%Y)
TIMESHEET="timesheets/${MONTH}-timesheet.csv"
INVOICE_FILE="invoices/${MONTH}-invoice.html"

# Import timesheet and create invoice
INVOICE_NUMBER=$(go-invoice import create "$TIMESHEET" --client "$CLIENT" --description "$MONTH Development Services" --output json | jq -r '.number')

# Generate HTML invoice
go-invoice generate invoice "$INVOICE_NUMBER" --output "$INVOICE_FILE"

# Update invoice status to sent
go-invoice invoice update "$INVOICE_NUMBER" --status sent

echo "Invoice $INVOICE_NUMBER created and sent for $CLIENT"