Skip to content

Task Commands

Manage task files using MeowKit templates.

task new

Create a new task file from a template.

bash
npx meowkit task new --type <type> "description"

Arguments:

ArgumentDescription
descriptionShort description (used in filename and title)

Flags:

FlagDescriptionDefault
--typeTemplate type: feature, bug-fix, refactor, securityfeature
--priorityPriority: critical, high, medium, lowmedium

Examples:

bash
npx meowkit task new --type feature "Add user authentication"
# Creates: tasks/active/260327-add-user-authentication.feature.md

npx meowkit task new --type bug-fix --priority high "Fix login timeout"
# Creates: tasks/active/260327-fix-login-timeout.bug-fix.md

task list

List task files with status.

bash
npx meowkit task list [--all] [--status <status>]

Flags:

FlagDescriptionDefault
--allInclude completed and backlog tasksfalse
--statusFilter by status: draft, in-progress, blocked, review, doneall

Examples:

bash
npx meowkit task list
# Lists active tasks only

npx meowkit task list --all
# Lists all tasks (active + completed + backlog)

npx meowkit task list --status blocked
# Lists only blocked tasks

Released under the MIT License.