PostHelper 1.0.1

📝 PostHelper CLI

Improve your tweets and social media posts with AI powered by the GitHub Copilot SDK.

✨ Features

• 🎨 Interactive UI - Beautiful ASCII art header, status display, and menu-driven workflow
• 🎯 Multiple Styles - Professional, Friendly, or Hype modes
• 😊 Emoji Control - Low, Default, or High emoji levels
• 📏 280 Character Limit - Automatically enforces Twitter/X limits
• 🤖 Smart Model Selection - Auto-selects efficient models (gpt-5-mini, gpt-4.1)
• 📋 Clipboard Support - Copy improved tweets directly to clipboard
• 📜 Session History - View all improvements made during session
• 📥 Dual Mode - Interactive UI or CLI for scripting/piping

📋 Prerequisites

• .NET 10.0 SDK or later
• GitHub Copilot CLI installed and authenticated

Installing GitHub Copilot CLI

# Windows (WinGet)
winget install GitHub.Copilot

# macOS/Linux (Homebrew)
brew install copilot-cli

# All platforms (npm)
npm install -g @github/copilot

Then authenticate:

copilot
# Type /login and follow the prompts

🚀 Installation

As a .NET Tool (Recommended)

dotnet tool install -g PostHelper

From Source

git clone https://github.com/jamesmontemagno/post-helper-cli.git
cd post-helper-cli
dotnet build

📖 Usage

Interactive Mode (Recommended)

Simply run without arguments for the full interactive experience:

post-helper

This launches the interactive UI with:

• ASCII art header and Copilot status check
• Auto-selected efficient model (gpt-5-mini or gpt-4.1)
• Menu to enter tweets, change style/emoji, view history
• Side-by-side comparison of original vs improved
• One-click copy to clipboard

CLI Mode

For scripting and piping, use arguments:

# With tweet as argument
post-helper "Check out my new blog post!"

# Pipe from stdin
echo "Check out my new blog post!" | post-helper

Style Options

# Professional style (default)
post-helper "Check out my new blog post!" --style Professional

# Friendly style
post-helper "Check out my new blog post!" --style Friendly

# Hype style
post-helper "Check out my new blog post!" --style Hype

Emoji Levels

# Low emojis (0-1)
post-helper "Check out my new blog post!" --emoji Low

# Default emojis (1-3)
post-helper "Check out my new blog post!" --emoji Default

# High emojis (3-5)
post-helper "Check out my new blog post!" --emoji High

Model Selection

# Specify model directly
post-helper "Check out my new blog post!" --model gpt-4o

# Interactive model picker (default when --model not specified)
post-helper "Check out my new blog post!"

Combined Options

post-helper "Just shipped a new feature!" --style Hype --emoji High --model gpt-4o

Piping Output

# Pipe improved tweet to clipboard (macOS)
post-helper "Check out my new blog post!" | pbcopy

# Pipe improved tweet to clipboard (Windows)
post-helper "Check out my new blog post!" | clip

🔧 CLI Options

🔐 Environment Variables

📦 Dependencies

• GitHub.Copilot.SDK - Official Copilot SDK
• Refractored.GitHub.Copilot.SDK.Helpers - CLI checker and model selection
• Spectre.Console - Beautiful console UI
• TextCopy - Cross-platform clipboard

📄 License

MIT License - see LICENSE for details.