typefully-cli

CLI for the Typefully API (v2). Made with api2cli.dev.

Manage social media drafts, schedule posts, upload media, and publish content across X, LinkedIn, Mastodon, Threads, and Bluesky.

Install

npx api2cli install Melvynx/typefully-cli

This clones the repo, builds the CLI, links it to your PATH, and installs the AgentSkill to your coding agents.

Install AgentSkill only

npx skills add Melvynx/typefully-cli

Usage

typefully-cli auth set "your-token"
typefully-cli auth test
typefully-cli --help

Resources

me

Command	Description
typefully-cli me --json	Get current authenticated user

social-sets

Command	Description
typefully-cli social-sets list --json	List all social sets (accounts)
typefully-cli social-sets get <id> --json	Get social set details with platform accounts
typefully-cli social-sets resolve-linkedin <social-set-id> --url <url> --json	Resolve LinkedIn company URL to mention syntax

drafts

Command	Description
typefully-cli drafts list <social-set-id> --json	List all drafts
typefully-cli drafts list <social-set-id> --status scheduled --json	List scheduled drafts
typefully-cli drafts get <social-set-id> <draft-id> --json	Get a draft by ID
typefully-cli drafts create <social-set-id> --text "Hello!" --platform x,linkedin --json	Create a draft
typefully-cli drafts create <social-set-id> --text "Now!" --publish-at now --json	Publish immediately
typefully-cli drafts create <social-set-id> --text "Queued" --publish-at next-free-slot --json	Schedule to next slot
typefully-cli drafts update <social-set-id> <draft-id> --text "Updated" --json	Update draft text
typefully-cli drafts delete <social-set-id> <draft-id> --json	Delete a draft

media

Command	Description
typefully-cli media upload <social-set-id> --file-name "photo.jpg" --json	Get presigned upload URL
typefully-cli media status <social-set-id> <media-id> --json	Check media processing status

tags

Command	Description
typefully-cli tags list <social-set-id> --json	List all tags
typefully-cli tags create <social-set-id> --name "Marketing" --json	Create a new tag

queue

Command	Description
typefully-cli queue view <social-set-id> --start 2026-03-01 --end 2026-03-31 --json	View queue slots
typefully-cli queue schedule <social-set-id> --json	Get queue schedule rules
typefully-cli queue schedule-set <social-set-id> --rules '<json>' --json	Replace queue schedule

Global Flags

All commands support: --json, --format <text|json|csv|yaml>, --verbose, --no-color, --no-header