| 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
