WordLift CLI 🚀

WordLift CLI - Your SEO Assistant - A personalized wrapper for Google's Gemini CLI with custom WordLift branding and additional features for content creation and SEO optimization.

🎨 WordLift CLI in Action

When you run npx wordlift-cli, you'll see the beautiful WordLift ASCII art logo:

██     ██  ██████  ██████  ██████  ██      ██ ███████ ████████
██     ██ ██    ██ ██   ██ ██   ██ ██      ██ ██         ██
██  █  ██ ██    ██ ██████  ██   ██ ██      ██ █████      ██
██ ███ ██ ██    ██ ██   ██ ██   ██ ██      ██ ██         ██
 ███ ███   ██████  ██   ██ ██████  ███████ ██ ██         ██

🚀 WordLift CLI - Your SEO Assistant

The CLI provides helpful tips to get you started:

1. Ask questions, edit files, or run commands.
2. Be specific for the best results.
3. /help for more information.

✨ Features

• Custom WordLift Branding: Beautiful ASCII art logo and personalized messaging
• SEO-Focused: Pre-configured for content creation and SEO optimization tasks
• Agent Memory System: SEOVoc-based knowledge graph integration for storing strategies and guidelines
• Easy Installation: Simple setup scripts for global or local installation
• Gemini Integration: Full compatibility with Google's Gemini CLI features
• Team Ready: Designed for collaborative content creation workflows

🚀 Quick Start

# Clone and install the WordLift CLI
git clone https://github.com/wordlift/wordlift-cli.git
cd wordlift-cli
./install.sh

# Or install globally for system-wide access
./setup-global.sh

Note: The package is not yet published to npm. We're working on publishing it to enable npx wordlift-cli installation.

📖 Usage

Once installed, you can use WordLift CLI just like Gemini CLI, but with WordLift branding:

# If installed locally
./bin/wordlift-cli.js

# If installed globally
wordlift-cli

# The CLI will show the WordLift logo and launch:
🚀 WordLift CLI - Your SEO Assistant

Tips for getting started:
1. Ask questions, edit files, or run commands.
2. Be specific for the best results.
3. /help for more information.

Example Commands

# Content creation
> Create a blog post about sustainable technology trends for 2025

# SEO optimization
> Analyze this article for SEO improvements and suggest meta descriptions

# Content strategy
> Help me create a content calendar for tech industry topics

# File editing
> Edit the article in output/tech-trends-2025.md to improve readability

📦 Installation Options

Option 1: Local Installation (Current Method)

git clone https://github.com/wordlift/wordlift-cli.git
cd wordlift-cli
./install.sh
./bin/wordlift-cli.js

Option 2: Global Installation

git clone https://github.com/wordlift/wordlift-cli.git
cd wordlift-cli
./setup-global.sh
wordlift-cli  # Available system-wide after global setup

Option 3: NPX (Coming Soon)

# This will be available once published to npm
npx wordlift-cli

🛠️ Configuration

WordLift CLI uses the same configuration as Gemini CLI. Set up your API key:

# Set your Gemini API key
export GEMINI_API_KEY="your-api-key-here"

# Or configure through the CLI
npx wordlift-cli
> /settings

📁 Project Structure

wordlift-cli/
├── bin/
│   ├── wordlift-cli.js          # Main CLI wrapper
│   └── wordlift-cli-standalone.js # Standalone version
├── .gemini/
│   └── settings.json            # Gemini CLI configuration
├── wordlift-ascii-art.txt       # Custom WordLift logo
├── package.json                 # NPM package configuration
├── install.sh                   # Local installation script
├── setup-global.sh              # Global installation script
└── README.md                    # This file

🔄 Staying Updated

WordLift CLI automatically uses the latest version of Gemini CLI when run via npx. For local installations:

# Update Gemini CLI
npm update @google/gemini-cli -g

# Pull latest WordLift CLI changes
git pull origin main

🤝 Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

Development Setup

# Clone the repository
git clone https://github.com/wordlift/wordlift-cli.git
cd wordlift-cli

# Install dependencies
npm install

# Test locally
./bin/wordlift-cli.js

Making Changes

1. Fork the repository
2. Create a feature branch: git checkout -b feature/amazing-feature
3. Make your changes
4. Test thoroughly
5. Commit your changes: git commit -m 'Add amazing feature'
6. Push to your branch: git push origin feature/amazing-feature
7. Open a Pull Request

📄 License

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

🆘 Support

• Issues: GitHub Issues
• Documentation: Setup Guide
• Contributing: Contributing Guide
• Agent Memory System: Testing Guide

🧠 Agent Memory System

WordLift CLI includes an advanced memory system for Agent WordLift that stores guidelines, strategies, and examples in a knowledge graph using SEOVoc vocabulary. This enables the agent to:

• Remember strategies across sessions
• Apply learned guidelines consistently
• Reference successful examples for content creation
• Build knowledge over time for better performance

For testing and validation, see the Agent Memory System Test Instructions.

🙏 Acknowledgments

• Built on top of Google's Gemini CLI
• WordLift team for the vision and branding
• Open source community for inspiration and contributions

Made with ❤️ by the WordLift team