special-octo-robot 1.0.2

Creating my own version of what a CLI Task manager and To-do-list would look like

Devcord

Devcord is a CLI tool designed to help you quickly manage your tasks as well as help you monitor your time usage. Along with all the essential to-do list functionalities, Devcord allows you to select a task and start a session on it.

During a session, your time-spent on each of your activity is monitored for you to view later. This is useful for people who want to find out where their time is spent.

None of the data is stored on any server, it is all stored locally on your machine.

Installation

Install Devcord using pip

pip install --upgrade special-octo-robot

Post Installation

To avoid typing devcord repetitively, register an alias in your shell configuration file.

Register an alias for tasks

alias tasks = "devcord tasks"          
alias task  = "devcord task"

Usage

For adding tasks

Description	Command
Add a simple task	devcord tasks -a "task name" devcord tasks --add "task name"
Add a task with a description (Opens scrollable text box to enter description)	devcord tasks -a "task name" -d devcord tasks --add "task name" --desc
Add a task with a due date	devcord tasks -a "task name" -dt "dd/mm/yyyy" devcord tasks --add "task name" --due "dd/mm/yyyy"
Add a task to be completed by today	devcord tasks -a "task name" -t devcord tasks --add "task name" --today
Add a task to be completed within the current week	devcord tasks -a "task name" -w devcord tasks --add "task name" --week
Add a task with priority (1-5)	devcord tasks -a "task name" -p 3 devcord tasks --add "task name" --priority 3
Add a task with labels	devcord tasks -a "task name" -lb "label" devcord tasks --add "task name" --label "label"
Add a subtask	devcord tasks -a "task name" -st devcord tasks --add "task name" --subtask

For listing tasks

By default, in-progress and pending tasks are listed, with in-progress first followed by pending tasks and completed tasks are skipped.

Description	Command
Simple List tasks	devcord tasks l devcord tasks --list
List tasks with subtasks	devcord tasks -l -st devcord tasks --list --subtasks
List tasks by priority	devcord tasks -l -p 3 devcord tasks --list --priority 3
List tasks by label	devcord tasks -l -lb "label" devcord tasks --list --label "label"
List tasks due today	devcord tasks -l -t devcord tasks --list --today
List tasks due in the current week	devcord tasks -l -w devcord tasks --list --week
List tasks by status	devcord tasks -l -i devcord tasks --list --completed devcord tasks -l --pending
Specify output format as JSON	devcord tasks -l -o json devcord tasks --list --output text
Specify output file path	devcord tasks -l --path "path/to/file"

For managing tasks

Pass the keyword to perform the required action on a task. The command will launch an interactive terminal UI menu where you can navigate through the task tree, or search for a task instantly by typing. The action will be performed on the selected task.

Description	Command
View task description (Opens a scrollable text box with description)	devcord task -d devcord task --desc
Show subtasks	devcord task -st devcord task --subtasks
Mark task as in-progress	devcord task -i devcord task --inprogress
Mark task as complete	devcord task -c devcord task --completed
Mark task as pending	devcord task -pd devcord task --pending
Set deadline to this week	devcord task -w devcord task --week
Set deadline to today	devcord task -t devcord task --today
Delete task	devcord task -dl devcord task --delete
Modify task title	devcord task -n "new title" devcord task --name "new title"
Modify task priority	devcord task -p 3 devcord task --priority 3
Modify task deadline	devcord task -dd "dd/mm/yyyy" devcord task --deadline "dd/mm/yyyy"
Modify task labels	devcord task -lb "label" devcord task --label "label"
Modify Completed Task	devcord task -ar -n "new title" devcord task --archive --name "new title"

For managing tables

Tables allow you to segregate your tasks into different lists (e.g. personal, work, etc.).

Description	Command
List all tables	devcord tables -l devcord tables --list
Add a new table	devcord tables -a "table_name" devcord tables --add "table_name"
Select an active table	devcord tables -sl "table_name" devcord tables --select "table_name"
Rename a table	devcord tables -n "table_name" devcord tables --name "table_name"
Delete a table	devcord tables -dl "table_name" devcord tables --delete "table_name"

For managing sessions

Sessions allow you to track time spent on specific tasks.

Description	Command
Start a session for a task	devcord session -st devcord session --start
End the current session	devcord session -ed devcord session --end
List all sessions	devcord session -l devcord session --list
Filter sessions by task	devcord session -fl devcord session --filter
View details of a specific session	devcord session -sl devcord session --select
Delete a session	devcord session -dl devcord session --delete

Jira Integration

With Jira integration you can view all your issues on devcord itself and sync them as when required with a single command. On your first use instead of the following commands, you'd be asked to set up your configuration for Jira.

Description	Command
Sync tasks with Jira	devcord jira --sync
Set organization URL for Jira	devcord jira --url
Set organization email for Jira	devcord jira --email
Set Jira access token	devcord jira --token

Miscellaneous