Sign InGet Started
DocsAPIMCPCLI

Posts & Content

Create, edit, publish, and delete posts. Manage comments, reactions, and media attachments from the command line.

Posts

Manage progress update posts. Alias: pf po

List posts, optionally filtered by project or status

alias: pf po ls

Options

--projectstringFilter by project ID
--statusstringFilter by status: draft or published
--limitnumberMax number of results
--cursorstringCursor for pagination
--sortstringSort by field
--reversebooleanReverse sort order

Example

pf posts list --project abc123
pf po ls --status draft --limit 5

Create a new post

alias: pf po create

Options

--titlestringPost title
--contentstringPost content (plain text)
--projectstringProject ID to post in
--statusstringInitial status: draft or published
--publishbooleanPublish immediately

Example

pf posts create --title "Sprint Update" --project abc123 --publish

View post details. Accepts a post number or full ID.

alias: pf po show

Example

pf posts view 3
pf po show    # interactive picker

Update a post

alias: pf po update

Options

--titlestringNew title
--contentstringNew content
--statusstringNew status
--move-to-projectstringMove post to a different project

Example

pf posts edit 3 --title "Updated Sprint Recap"

Delete a post permanently

alias: pf po rm

Options

--confirmbooleanSkip confirmation prompt
--dry-runbooleanPreview without deleting

Example

pf posts delete 3 --confirm

Publish a draft post

Example

pf posts publish 3

Revert a published post back to draft

Example

pf posts unpublish 3

Comments

Add, edit, and delete comments on posts. Supports threaded replies. Alias: pf c

List comments on a post

alias: pf c ls

Example

pf comments list 3

Add a comment to a post

alias: pf c add

Options

--contentstringrequiredComment text
--reply-tostringParent comment ID for threading

Example

pf comments add 3 --content "Great progress!"
pf c add 3 --content "Agreed" --reply-to comment123

Edit a comment on a post

Options

--contentstringrequiredNew comment text

Example

pf comments edit 3 comment123 --content "Updated feedback"

Delete a comment from a post

alias: pf c rm

Options

--confirmbooleanSkip confirmation prompt
--dry-runbooleanPreview without deleting

Example

pf comments delete 3 comment123 --confirm

Reactions

Toggle reactions on posts. Alias: pf r

Toggle a reaction on a post. Use standard emoji or custom:name format.

alias: pf r add

Example

pf reactions toggle 3 🚀
pf r add 3 custom:fire

Files

Upload, list, view, and delete file attachments. Alias: pf m

List media attachments. Filter by exactly one parent type. If no id filter is set, defaults to listing post attachments.

alias: pf m ls

Options

--poststringFilter by post ID
--commentstringFilter by comment ID
--taskstringFilter by task ID
--task-commentstringFilter by task-comment ID
--targetstringOverride target kind: post | comment | task | taskComment
--typestringFilter by media type
--limitnumberMax number of results
--cursorstringCursor for pagination

Example

pf media list --task task123
pf media list --comment com123 --type image
pf media list --target task --limit 20

Upload a file as media to a post, comment, task, or task-comment. Exactly one of the parent-id flags is required.

alias: pf m upload

Options

--poststringPost ID to attach media to
--commentstringComment ID to attach media to
--taskstringTask ID to attach media to
--task-commentstringTask-comment ID to attach media to
--targetstringExplicit target kind; must match the id flag when both are set

Example

pf media upload screenshot.png --post post123
pf media upload diagram.png --task task456
pf media upload voice-memo.mp3 --comment com789

View media details. Pass --target for non-post attachments (defaults to post).

alias: pf m show

Options

--targetstringTarget kind: post | comment | task | taskComment (default: post)

Example

pf media view media123
pf media view media123 --target task

Delete a media attachment. Pass --target for non-post attachments (defaults to post).

alias: pf m rm

Options

--targetstringTarget kind: post | comment | task | taskComment (default: post)
--confirmbooleanSkip confirmation prompt
--dry-runbooleanPreview without deleting

Example

pf media delete media123 --confirm
pf media delete media456 --target comment --confirm