PLANIFY-CLI(1)

πŸ“¦ version 4.19.1, in ubuntu stonking

✨ planify-cli ✨

okay bestie, welcome to planify-cli(1) β€” the command-line interface for Planify task manager πŸŽ€ this is a User Commands page and it's literally your terminal-side glow-up for getting stuff done. no cap. πŸ’…


🌸 NAME 🌸

planify-cli β€” command-line interface for Planify task manager πŸ¦‹


🫢 SYNOPSIS 🫢

planify-cli <command> [OPTIONS]

πŸ‘‘ DESCRIPTION πŸ‘‘

So like… planify-cli is a command-line tool for managing tasks in Planify ✨ It gives you the power to create, list, and update tasks, plus manage projects, and you do it all directly from the terminal. no app-switching, no mouse, just vibes. 🌈


πŸ’– COMMANDS πŸ’–

  • add β€” Add a new task to Planify. βž•
planify-cli add [OPTIONS]
  • list β€” List tasks from a project. πŸ“‹
planify-cli list [OPTIONS]
  • update β€” Update an existing task. Only provided fields will be changed. ✏️ (the way it respects your boundaries… iconic)
planify-cli update [OPTIONS]
  • list-projects β€” List all projects. πŸ—‚οΈ
planify-cli list-projects

✨ OPTIONS ✨

πŸ’« Global Options

  • -h, --help β€” Show help for the command. your bestie when you're lost fr fr πŸ™ˆ

πŸ“ add command options:

  • -c, --content=CONTENT β€” Task content (required, so don't ghost it πŸ’€)
  • -d, --description=DESC β€” Task description
  • -p, --project=PROJECT β€” Project name (defaults to inbox πŸ“₯)
  • -i, --project-id=ID β€” Project ID (preferred over name πŸ‘‘)
  • -s, --section=SECTION β€” Section name
  • -S, --section-id=ID β€” Section ID (preferred over name πŸ‘‘)
  • -a, --parent-id=ID β€” Parent task ID (creates a subtask πŸͺ†)
  • -P, --priority=1-4 β€” Priority: 1=high, 2=medium, 3=low, 4=none (default: 4)
  • -D, --due=DATE β€” Due date in YYYY-MM-DD format πŸ“…
  • -l, --labels=LABELS β€” Comma-separated list of label names 🏷️
  • --pin=true|false β€” Pin or unpin the task πŸ“Œ

🧚 list command options:

  • -p, --project=PROJECT β€” Project name (defaults to inbox πŸ“₯)
  • -i, --project-id=ID β€” Project ID (preferred over name πŸ‘‘)

πŸ’œ update command options:

  • -t, --task-id=ID β€” Task ID to update (required ⚠️)
  • -c, --content=CONTENT β€” New task content
  • -d, --description=DESC β€” New task description
  • -p, --project=PROJECT β€” Move to project by name 🚚
  • -i, --project-id=ID β€” Move to project by ID (preferred over name πŸ‘‘)
  • -s, --section=SECTION β€” Section name
  • -S, --section-id=ID β€” Section ID (preferred over name πŸ‘‘)
  • -a, --parent-id=ID β€” New parent task ID
  • -P, --priority=1-4 β€” Priority: 1=high, 2=medium, 3=low, 4=none
  • -D, --due=DATE β€” Due date in YYYY-MM-DD format πŸ“…
  • -l, --labels=LABELS β€” Comma-separated list of label names 🏷️
  • --complete=true|false β€” Mark task as complete or incomplete βœ…
  • --pin=true|false β€” Pin or unpin the task πŸ“Œ

🌟 EXAMPLES 🌟

  1. Get help for a specific command:
planify-cli add --help
planify-cli list --help
planify-cli update --help
  1. Add a new high-priority task to the inbox:
planify-cli add -c "Finish report" -P 1
  1. Add a task with description and due date to a specific project:
planify-cli add -c "Team meeting" -d "Weekly sync" -p "Work" -D 2024-12-20
  1. List tasks from the inbox:
planify-cli list
  1. List tasks from a specific project:
planify-cli list -p "Personal"
  1. Update a task's priority and mark as complete:
planify-cli update -t TASK_ID -P 2 --complete=true
  1. List all projects:
planify-cli list-projects

πŸ’Œ NOTES πŸ’Œ

  • When both name and ID options are available (e.g., --project and --project-id), the ID option is preferred. πŸ‘‘
  • The update command only modifies fields that are explicitly provided. nothing extra gets touched, we love a careful queen πŸ’…
  • Priority levels: 1 (highest) to 4 (none/lowest). πŸ”₯
  • Date format must be YYYY-MM-DD for due dates. πŸ—“οΈ
  • Labels should be provided as a comma-separated list without spaces: label1,label2,label3. 🏷️

πŸ¦‹ SEE ALSO πŸ¦‹

planify(1) planify-quick-add(1) β€” go read those too, they're giving main character energy πŸ’–


πŸ’€ BUGS πŸ’€

Report bugs to the Planify issue tracker. πŸ› (not me manifesting none, but like, just in case)


🌈 AUTHOR 🌈

Planify Development Team 🫢


Copyright Β© 2023-2026 Alain M.


and that's the whole page, bestie πŸ’– this was planify-cli, from April 2026 ✨ planify-cli β€” April 2026 πŸ¦‹ periodt, go forth and organize your life πŸ’…πŸŒŸ

πŸ“¦ where this page comes from