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

Media

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

List media attachments

alias: pf m ls

Options

--poststringFilter by post ID

--typestringFilter by media type

--limitnumberMax number of results

--cursorstringCursor for pagination

Example

pf media list --post post123 --type image

Upload a file as media to a post

alias: pf m upload

Options

--poststringrequiredPost ID to attach media to

Example

pf media upload screenshot.png --post post123

View media details

alias: pf m show

Example

pf media view media123

Delete a media attachment

alias: pf m rm

Options

--confirmbooleanSkip confirmation prompt

--dry-runbooleanPreview without deleting

Example

pf media delete media123 --confirm

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

Media

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

List media attachments

alias: pf m ls

Options

--poststringFilter by post ID

--typestringFilter by media type

--limitnumberMax number of results

--cursorstringCursor for pagination

Example

pf media list --post post123 --type image

Upload a file as media to a post

alias: pf m upload

Options

--poststringrequiredPost ID to attach media to

Example

pf media upload screenshot.png --post post123

View media details

alias: pf m show

Example

pf media view media123

Delete a media attachment

alias: pf m rm

Options

--confirmbooleanSkip confirmation prompt

--dry-runbooleanPreview without deleting

Example

pf media delete media123 --confirm