name: typefully-cli-v2
description: "Manage typefully via CLI - me, social-sets, drafts, tags, media. Use when user mentions 'typefully' or wants to interact with the typefully API."
typefully-cli-v2
Setup
If typefully-cli-v2 is not found, install and build it:
bun --version || curl -fsSL https://bun.sh/install | bash
npx api2cli bundle typefully
npx api2cli link typefully
api2cli link adds ~/.local/bin to PATH automatically. The CLI is available in the next command.
Always use --json flag when calling commands programmatically.
Authentication
typefully-cli-v2 auth set "your-token"
typefully-cli-v2 auth test
Resources
me
| Command |
Description |
typefully-cli-v2 me --json |
Get authenticated user info |
social-sets
| Command |
Description |
typefully-cli-v2 social-sets list --json |
List all social sets (accounts) |
typefully-cli-v2 social-sets get <id> --json |
Get social set details |
drafts
| Command |
Description |
typefully-cli-v2 drafts list <social-set-id> --json |
List drafts for a social set |
typefully-cli-v2 drafts get <social-set-id> <draft-id> --json |
Get a specific draft |
typefully-cli-v2 drafts create <social-set-id> --text "Hello" --platform x --json |
Create a draft |
typefully-cli-v2 drafts create <social-set-id> --text "Hello" --platform x,linkedin,threads --json |
Create multi-platform draft |
typefully-cli-v2 drafts create <social-set-id> --text "Hello" --publish-at now --json |
Create and publish immediately |
typefully-cli-v2 drafts create <social-set-id> --text "Hello" --publish-at next-free-slot --json |
Schedule to next free slot |
typefully-cli-v2 drafts create <social-set-id> --text "Hello" --publish-at 2025-02-01T09:00:00Z --json |
Schedule at specific time |
typefully-cli-v2 drafts create <social-set-id> --text "Hello" --tags marketing,launch --json |
Create with tags |
typefully-cli-v2 drafts create-raw <social-set-id> --body '{"platforms":{"x":{"enabled":true,"posts":[{"text":"Hello"}]}}}' --json |
Create with raw JSON |
typefully-cli-v2 drafts update <social-set-id> <draft-id> --text "Updated" --json |
Update a draft |
typefully-cli-v2 drafts delete <social-set-id> <draft-id> --json |
Delete a draft |
tags
| Command |
Description |
typefully-cli-v2 tags list <social-set-id> --json |
List tags for a social set |
typefully-cli-v2 tags create <social-set-id> --name "Marketing" --json |
Create a new tag |
media
| Command |
Description |
typefully-cli-v2 media upload <social-set-id> --file-name "image.jpg" --json |
Get presigned upload URL |
typefully-cli-v2 media status <social-set-id> <media-id> --json |
Check media processing status |
Global Flags
All commands support: --json, --format <text|json|csv|yaml>, --verbose, --no-color, --no-header
By