mayrlabs-go

🧰 MayR Labs CLI

MayR Labs CLI is a lightweight, cross-platform command-line tool built with Go to streamline common development, configuration, and automation tasks across projects.

It aims to provide developers with a unified interface for generating configs, formatting code, managing environments, handling CI/CD, and keeping project structure consistent — all in seconds.

🚀 Features

• Consistent project setup and formatting across multiple languages.
• Fast cross-platform DNS cache clearing.
• Auto-generation of CI/CD configuration files for major languages and VCS providers.
• Easy license creation and editor configuration.
• Smart environment file management and changelog handling.
• Integrated support for Flutter, PHP, JavaScript, and Go workflows.

📦 Installation

Using Installation Script (Recommended)

The easiest way to install mayrlabs is using our installation script:

# Using curl
curl -sSL https://raw.githubusercontent.com/MayR-Labs/mayrlabs-go/main/install.sh | bash

# Or using wget
wget -qO- https://raw.githubusercontent.com/MayR-Labs/mayrlabs-go/main/install.sh | bash

The script automatically:

• Detects your operating system and architecture
• Downloads the latest release
• Installs the binary to an appropriate location
• Verifies the installation

Using Go Install

If you have Go 1.17+ installed:

go install github.com/MayR-Labs/mayrlabs-go@latest

Note: This will install the binary as mayrlabs-go (not mayrlabs) in your $GOPATH/bin directory. You can create an alias or symlink:

# Create an alias (add to your ~/.bashrc or ~/.zshrc)
alias mayrlabs='mayrlabs-go'

# Or create a symlink
ln -s $(which mayrlabs-go) $(dirname $(which mayrlabs-go))/mayrlabs

Ensure $GOPATH/bin is in your PATH:

Add this to your shell configuration file (~/.bashrc, ~/.zshrc, or ~/.profile):

export PATH="$GOPATH/bin:$PATH"
# or if GOPATH is not set
export PATH="$HOME/go/bin:$PATH"

Then reload your shell configuration:

source ~/.bashrc  # or ~/.zshrc, ~/.profile depending on your shell

Download Pre-built Binaries

Download the latest release for your platform from the Releases page:

Linux (AMD64):

curl -L https://github.com/MayR-Labs/mayrlabs-go/releases/latest/download/mayrlabs-linux-amd64 -o mayrlabs
chmod +x mayrlabs
sudo mv mayrlabs /usr/local/bin/

macOS (Apple Silicon):

curl -L https://github.com/MayR-Labs/mayrlabs-go/releases/latest/download/mayrlabs-darwin-arm64 -o mayrlabs
chmod +x mayrlabs
sudo mv mayrlabs /usr/local/bin/

Windows: Download mayrlabs-windows-amd64.exe from the releases page and add it to your PATH.

Build from Source

Clone and build manually:

git clone https://github.com/MayR-Labs/mayrlabs-go.git
cd mayrlabs-go
make build
# Or: go build -o mayrlabs main.go

# Optionally install to system
sudo mv mayrlabs /usr/local/bin/

Verify Installation

mayrlabs --version
mayrlabs --help

🧭 Usage

Basic Usage

mayrlabs [command] [flags]

Get Help

# General help
mayrlabs --help

# Help for specific command
mayrlabs [command] --help

# Example
mayrlabs ci --help

Interactive Mode

Most commands support interactive mode if you omit required parameters:

# Will prompt you for language and VCS
mayrlabs ci

# Will prompt for language
mayrlabs format

📚 Quick Start Examples

Setup a New Project

# Generate editor configuration
mayrlabs editor-config go

# Add MIT license
mayrlabs add-license --type mit --author "Your Name" --year 2025

# Create CI/CD workflow
mayrlabs ci --lang go --vcs github

# Create changelog
mayrlabs changelog create

Generate Utilities

# Generate a UUID
mayrlabs uuid
# Output: 550e8400-e29b-41d4-a716-446655440000

# Generate a UUID and copy to clipboard
mayrlabs uuid --copy

# Generate a secure password (32 characters)
mayrlabs password 32
# Output: Xy9$mK2#pL8vN@qR5wT7uZ1aB3cD6eF0

# Generate a random integer
mayrlabs random-int
# Will prompt for min and max values

# Hash a string
mayrlabs hash "my-secret" --algorithm sha256
# Output: my-secret (sha256): 8d969eef6ecad3c29a3a629280e686cf0c3f5d5a86aff3ca12020c923adc6c92

# Roll 3 dice
mayrlabs roll-dice 3
# Output: Results: [4 1 3], Total: 8, Average: 2.67

AI Features

# Setup AI with your Gemini API key
mayrlabs ai-setup

# Ask a question to the AI
mayrlabs ai "How do I implement binary search in Go?"

# Send a file's content to the AI for review
mayrlabs ai-file mycode.go

# Create an alias for ai command
mayrlabs ai-alias ask
# Now you can use: ask "your question"

# Clear the stored API key
mayrlabs ai-clear

Session Management

# Start a development session
mayrlabs session-start "Implementing user authentication"

# List all sessions
mayrlabs sessions

# Start a secure encrypted session
mayrlabs secure-session-start "Sensitive feature work"

# List secure sessions
mayrlabs secure-sessions

# Prune old sessions (older than 30 days)
mayrlabs session-prune 30

# Clear all sessions (requires PIN)
mayrlabs session-clear

Encoding/Decoding

# Base64 encode a string
mayrlabs base64 encode "Hello World"
# Output: SGVsbG8gV29ybGQ=

# Base64 decode a string
mayrlabs base64 decode "SGVsbG8gV29ybGQ="
# Output: Hello World

# Encode a file to base64
mayrlabs base64-file myfile.txt --copy

# Decode base64 to a file
mayrlabs base64-decode-to-file "SGVsbG8gV29ybGQ=" output.txt

System Management

# Create an alias for mayrlabs
mayrlabs alias ml

# List all aliases
mayrlabs alias-list

# Clear all aliases (with confirmation)
mayrlabs alias-clear

# Upgrade to latest version
mayrlabs upgrade

Environment Management

# Validate your .env file
mayrlabs env validate

# Update .env.example from .env
mayrlabs env update-example

# Organize .env by prefix (APP_*, DB_*, etc.)
mayrlabs env arrange

Code Formatting

# Format Go code
mayrlabs format go

# Format JavaScript code
mayrlabs format javascript

# Format Python code
mayrlabs format python

Git Operations

# Remove stale local branches
mayrlabs git prune-stale

⚙️ Commands

🧱 General Commands

🔧 System Commands

🔐 Encoding/Decoding Commands

🌿 Git Commands

🔐 ENV Commands

📝 CHANGELOG Commands

🐦 Flutter Commands

🐘 PHP Commands

⚡ JavaScript Commands

🤖 AI Commands

📝 Session Management Commands

🏷️ Alias Management Commands

🧠 Practical Examples

Example 1: Setup a Go Project

# Initialize project files
mayrlabs editor-config go
mayrlabs add-license --type mit --author "Your Name" --year 2025
mayrlabs ci --lang go --vcs github
mayrlabs changelog create

# Format code
mayrlabs format go

Example 2: Setup a JavaScript Project

# Configure project
mayrlabs editor-config javascript
mayrlabs js setup-prettier
mayrlabs add-license --type mit --author "Your Team" --year 2025

# Generate CI
mayrlabs ci --lang javascript --vcs github

# Format code
mayrlabs js pretty

Example 3: Manage Environment Files

# After adding variables to .env
mayrlabs env validate          # Check for errors
mayrlabs env arrange           # Organize by prefix
mayrlabs env update-example    # Sync .env.example

Example 4: Flutter Project Setup

# Generate build scripts
mayrlabs flutter create-scripts

# This creates:
# - scripts/build-apk.sh
# - scripts/build-apk-release.sh
# - scripts/build-appbundle.sh
# - scripts/build-ios.sh
# - scripts/build-ipa.sh
# - scripts/clean.sh
# - scripts/run-tests.sh

# Run a script
./scripts/build-apk-release.sh

Example 5: Generate CI for Different Platforms

# GitHub Actions for Go
mayrlabs ci --lang go --vcs github

# GitLab CI for Python
mayrlabs ci --lang python --vcs gitlab

# GitHub Actions for Flutter
mayrlabs ci --lang flutter --vcs github

🏗️ Tech Stack

• Language: Go
• Framework: Cobra
• Build: Single static binary
• Platforms: macOS, Linux, Windows

🤝 Contributing

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

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🔗 Links

• GitHub: https://github.com/MayR-Labs/mayrlabs-go
• Issues: Report a Bug
• Documentation:
  • Examples - Usage examples and workflows
  • API Reference - Complete command reference
  • Architecture - Technical architecture and design
  • Development Guide - Contributing and development setup

💡 Need Help?

• Check the examples directory for more usage scenarios
• Run mayrlabs [command] --help for command-specific help
• Open an issue on GitHub for bug reports or feature requests

Built with ❤️ by MayR Labs