I Built a Multi-Platform Publishing CLI for AI Agents

I contribute to open-source repos regularly. Every time, I'd manually copy-paste the same article to Dev.to, GitHub, LinkedIn — each with different formatting, different APIs, different auth flows. So I built a CLI that does it all from one command.

The Problem

When you contribute to an open-source project, you often want to:

1. Write a blog post about it


2. Push the code to GitHub


3. Share on Dev.to for visibility


4. Cross-post to LinkedIn

Each platform has its own API, auth method, and markdown handling. Doing this manually is tedious and error-prone.

The Solution: Platform Picker

A single CLI script that publishes content across multiple platforms:

# Publish to one platform

python3 platform_picker.py publish --file article.md --platform devto



# Publish to multiple platforms at once

python3 platform_picker.py publish --file article.md --platform devto --platform linkedin



# Check which platforms are configured

python3 platform_picker.py status

Supported Platforms

How It Works

1. One-time setup per platform

python3 platform_picker.py setup devto --api-key YOUR_KEY

python3 platform_picker.py setup github --token YOUR_PAT

Credentials are stored in ~/.hermes/config.yaml — never hardcoded in scripts.

2. Write your content once

A single markdown file with YAML frontmatter:

---

title: "Your Article Title"

tags: [ai, automation]

---



# Your content here



Works across all platforms.

3. Publish everywhere

The CLI handles the differences:

• Dev.to gets full markdown with tags


• GitHub creates a public gist


• LinkedIn gets plain text (truncated to 3000 chars)


• HermesHub gets the skill directory submitted via GitHub OAuth

Real-World Test

I tested this by publishing an article to Dev.to:

$ python3 platform_picker.py publish --file /tmp/test.md --platform devto

--- Publishing to devto ---

  Published! ID: 3868710

  URL: https://dev.to/saintchris_21/test-platform-picker-cli-186o

The article went live with correct title, body, and tags — all from one command.

Error Handling

The CLI handles common failures gracefully:

$ python3 platform_picker.py publish --file article.md --platform github

Platform not configured: github. Run 'setup github' first.



$ python3 platform_picker.py publish --file missing.md --platform devto

File not found: missing.md

Building It

The script is ~200 lines of Python using httpx for API calls and PyYAML for config. It:

1. Reads credentials from ~/.hermes/config.yaml
   


2. Parses frontmatter from the markdown file


3. Adapts the content for each platform's API


4. Publishes and returns the URL

The hardest part was handling the different auth methods — Dev.to uses a simple API key header, GitHub uses a Bearer token, and LinkedIn needs OAuth 2.0 with a person URN lookup.

What's Next

I'm working on adding:

• 
  Twitter/X — thread publishing


• 
  Medium — story publishing


• 
  Substack — newsletter integration


• 
  Scheduled publishing — publish at a specific time

The goal: write once, publish everywhere, from your terminal.

The platform picker is part of the hermes-skills repo. Both skills (open-source-contribution and platform-picker) are submitted to HermesHub for community use.

If you're building AI agent workflows, I'd love to hear what platforms you'd add.