Projects & Tasks

Manage projects and tasks from the command line. Projects organize work into spaces; tasks track individual items with status, priority, assignees, and due dates.

Projects

Create, list, view, edit, and archive projects. Alias: pf p

List all projects in the workspace

alias: pf p ls

Options

--show-archivedbooleanInclude archived projects

--sortstringSort by field (e.g., name, createdAt)

--reversebooleanReverse sort order

Example

pf projects list
pf projects list --show-archived
pf p ls --sort name

Create a new project. Runs interactively when no flags are provided.

Options

--namestringProject name

--descriptionstringProject description

--colorstringProject color (hex or name)

--visibilitystringVisibility: public or private

Example

pf projects create --name "Design System" --visibility private

View project details. Opens an interactive picker if no ID is given.

alias: pf p show

Example

pf projects view abc123
pf p show    # interactive picker

Update project properties

alias: pf p update

Options

--namestringNew project name

--descriptionstringNew description

--colorstringNew color

--visibilitystringNew visibility: public or private

--archivedbooleanSet archived state

Example

pf projects edit abc123 --name "Design System v2"

Archive or unarchive a project

Options

--unarchivebooleanUnarchive instead of archive

--confirmbooleanSkip confirmation prompt

--dry-runbooleanPreview without making changes

Example

pf projects archive abc123
pf projects archive abc123 --unarchive

Tasks

Create, list, view, and edit tasks. Manage task comments and link tasks to posts. Alias: pf t

List tasks, optionally filtered by status or priority

alias: pf t ls

Options

--projectstringFilter by project ID

--statusstringFilter by status: backlog, todo, in_progress, in_review, done, cancelled

--prioritystringFilter by priority: none, low, medium, high, urgent

--limitnumberMax number of results

--offsetnumberSkip this many results (pagination)

--sortstringSort by field

--reversebooleanReverse sort order

Example

pf tasks list --status in_progress
pf t ls --priority high --sort priority --reverse
pf tasks list --project abc123 --limit 10

Create a new task. Runs interactively when no flags are provided.

alias: pf t create

Options

--titlestringTask title

--projectstringProject ID

--descriptionstringPlain text description

--description-mdstringMarkdown description

--statusstringInitial status: backlog, todo, in_progress, in_review, done, cancelled

--prioritystringPriority: none, low, medium, high, urgent

--assigneestringAssignee user ID

--due-datestringDue date (ISO 8601)

--start-datestringStart date (ISO 8601)

--pointsnumberStory points estimate

Example

pf tasks create --title "Fix login bug" --priority high --status todo
pf t create --title "Update docs" --project abc123 --due-date 2025-03-15

View task details. Accepts a task number or full ID. Interactive picker if omitted.

alias: pf t show

Example

pf tasks view 42
pf t show    # interactive picker

Update task properties

alias: pf t update

Options

--titlestringNew title

--descriptionstringNew plain text description

--description-mdstringNew markdown description

--statusstringNew status

--prioritystringNew priority

--assigneestringNew assignee user ID

--due-datestringNew due date

--start-datestringNew start date

--pointsnumberNew story points

--move-to-projectstringMove task to a different project

Example

pf tasks edit 42 --status done
pf t update 42 --priority urgent --assignee user123

List comments on a task

alias: pf t comment ls

Example

pf tasks comment list 42

Add a comment to a task

Options

--contentstringrequiredComment text

Example

pf tasks comment add 42 --content "Looks good, merging now"

Edit a task comment

Options

--contentstringrequiredNew comment text

Example

pf tasks comment edit 42 comment123 --content "Updated review notes"

Delete a task comment

alias: pf t comment rm

Options

--confirmbooleanSkip confirmation prompt

--dry-runbooleanPreview without deleting

Example

pf tasks comment delete 42 comment123 --confirm

Link a task to a post

Example

pf tasks link 42 post123

Remove post links from a task

Options

--confirmbooleanSkip confirmation prompt

--dry-runbooleanPreview without unlinking

Example

pf tasks unlink 42

Projects

Create, list, view, edit, and archive projects. Alias: pf p

List all projects in the workspace

alias: pf p ls

Options

--show-archivedbooleanInclude archived projects

--sortstringSort by field (e.g., name, createdAt)

--reversebooleanReverse sort order

Example

pf projects list
pf projects list --show-archived
pf p ls --sort name

Create a new project. Runs interactively when no flags are provided.

Options

--namestringProject name

--descriptionstringProject description

--colorstringProject color (hex or name)

--visibilitystringVisibility: public or private

Example

pf projects create --name "Design System" --visibility private

View project details. Opens an interactive picker if no ID is given.

alias: pf p show

Example

pf projects view abc123
pf p show    # interactive picker

Update project properties

alias: pf p update

Options

--namestringNew project name

--descriptionstringNew description

--colorstringNew color

--visibilitystringNew visibility: public or private

--archivedbooleanSet archived state

Example

pf projects edit abc123 --name "Design System v2"

Archive or unarchive a project

Options

--unarchivebooleanUnarchive instead of archive

--confirmbooleanSkip confirmation prompt

--dry-runbooleanPreview without making changes

Example

pf projects archive abc123
pf projects archive abc123 --unarchive

Tasks

Create, list, view, and edit tasks. Manage task comments and link tasks to posts. Alias: pf t

List tasks, optionally filtered by status or priority

alias: pf t ls

Options

--projectstringFilter by project ID

--statusstringFilter by status: backlog, todo, in_progress, in_review, done, cancelled

--prioritystringFilter by priority: none, low, medium, high, urgent

--limitnumberMax number of results

--offsetnumberSkip this many results (pagination)

--sortstringSort by field

--reversebooleanReverse sort order

Example

pf tasks list --status in_progress
pf t ls --priority high --sort priority --reverse
pf tasks list --project abc123 --limit 10

Create a new task. Runs interactively when no flags are provided.

alias: pf t create

Options

--titlestringTask title

--projectstringProject ID

--descriptionstringPlain text description

--description-mdstringMarkdown description

--statusstringInitial status: backlog, todo, in_progress, in_review, done, cancelled

--prioritystringPriority: none, low, medium, high, urgent

--assigneestringAssignee user ID

--due-datestringDue date (ISO 8601)

--start-datestringStart date (ISO 8601)

--pointsnumberStory points estimate

Example

pf tasks create --title "Fix login bug" --priority high --status todo
pf t create --title "Update docs" --project abc123 --due-date 2025-03-15

View task details. Accepts a task number or full ID. Interactive picker if omitted.

alias: pf t show

Example

pf tasks view 42
pf t show    # interactive picker

Update task properties

alias: pf t update

Options

--titlestringNew title

--descriptionstringNew plain text description

--description-mdstringNew markdown description

--statusstringNew status

--prioritystringNew priority

--assigneestringNew assignee user ID

--due-datestringNew due date

--start-datestringNew start date

--pointsnumberNew story points

--move-to-projectstringMove task to a different project

Example

pf tasks edit 42 --status done
pf t update 42 --priority urgent --assignee user123

List comments on a task

alias: pf t comment ls

Example

pf tasks comment list 42

Add a comment to a task

Options

--contentstringrequiredComment text

Example

pf tasks comment add 42 --content "Looks good, merging now"

Edit a task comment

Options

--contentstringrequiredNew comment text

Example

pf tasks comment edit 42 comment123 --content "Updated review notes"

Delete a task comment

alias: pf t comment rm

Options

--confirmbooleanSkip confirmation prompt

--dry-runbooleanPreview without deleting

Example

pf tasks comment delete 42 comment123 --confirm

Link a task to a post

Example

pf tasks link 42 post123

Remove post links from a task

Options

--confirmbooleanSkip confirmation prompt

--dry-runbooleanPreview without unlinking

Example

pf tasks unlink 42