Migration Guide: Legacy to New CLI

Note

v2.0 Package Split: This guide covers CLI migration (v2.0+). For v2.0 package split and import path changes, see the sections below on “Package Installation” and “Import Path Changes”.

Overview

Agoras uses a platform-first CLI structure that is more intuitive, discoverable, and aligned with how users think about social media operations. This guide helps you migrate from the legacy agoras publish command to the new agoras <platform> <action> format.

This migration guide is organized into the following sections:

• Package Installation (v2.0+)
• Understanding the Package Split
  • Why Split the Package?
  • Package Responsibilities
  • Migration Strategy
• Import Path Changes (v2.0)
  • Common Utilities
  • Media Processing
  • Core Interfaces
  • Platform Implementations
  • Core Business Logic (Unchanged)
  • CLI Commands
  • Authentication
• CLI Commands Migration
  • Why the Change?
• Quick Reference
  • Platform Commands
  • Automation Commands
• Parameter Changes
  • Authentication Parameters
  • Content Parameters
• Async/Await Pattern (v2.0)
• Platform-by-Platform Migration
  • X (formerly Twitter)
  • Facebook
  • Instagram
  • LinkedIn
  • Discord
  • YouTube
  • TikTok
  • Threads
• Platform-Specific Notes
  • Facebook
  • Instagram
  • LinkedIn
  • TikTok
  • YouTube
  • New Platforms (v2.0)
• Automation Commands Migration
  • Feed Automation
  • Schedule Automation
• Testing Your Migration
  • Preview Mode
  • Platform-Specific Help
• Gradual Migration Strategy
• Test Migration
  • Update Your Test Imports
  • Mock Strategy Changes
  • Pytest Configuration
• CI/CD Migration
  • GitHub Actions
  • Dependency Pinning
  • Docker/Container Environments
• Complete Parameter Reference
  • X (formerly Twitter) Parameters
  • Facebook Parameters
  • Content Parameters (All Platforms)
  • Feed Parameters
  • Google Sheets Parameters
• Frequently Asked Questions
  • Installation & Packages
  • CLI Commands
  • OAuth 2.0 Authentication
  • Parameter Names
  • Import Paths (Python)
  • Migration Timeline
• Common Migration Pitfalls
• Troubleshooting
• Getting Help
• See Also
• Resources
• Support Timeline

Quick Start

If you’re in a hurry, here’s the quickest path to migration:

1. Update Installation: pip install agoras>=2.0.0

2. Update Commands: Replace agoras publish --network <platform> --action <action> with agoras <platform> <action>

3. Update Parameters: Remove platform prefixes (e.g., --twitter-consumer-key → --consumer-key)

4. For OAuth Platforms: Run agoras <platform> authorize first

For detailed information, see the sections below.