Commands
List of commands
Output commands:
describe
provides the full BusyML descriptionsimple
includes less detail thandescribe
list
is likedescribe
but with sequence numbersview
outputs specific fields - for now only theval
fieldsqueues
to lists all the queuestags
to lists tags from a queue
Commands that make changes:
add
adds a new itemdone
marks an item as 'done' and gives the option of iterating - "done for today"defer
puts a task or set of items on the plan for a future datepop
moves a task or set of items to the top of a queue - "pop it to the top"drop
moves a task or set of items to the bottom of a queue - "drop it to the bottom"pick
moves one random item from the filtered set to the top of the queue - "pick one for me"delete
permanently removes a task or set of items from a queueedit
opens a text editor to edit items - the default is to edit only the top itemmanage
is the same asedit
, but defaults to edit the whole collectionactivate
finds everything planned for today and adds it to the list - "activate my day"
Common options
- filters to designate items to be acted upon, using sequence numbers or tags
- the
add
command requires a description of the new item instead of filters --queue
if not the defaulttasks
queue--help
to find out which options apply--yes
to skip confirmation of any command that requires it--state
to work on Items of a different state (todo
,plan
,done
)--when
applies to thedefer
command--defer
applies to thedone
command--fields
and--unique
apply to theview
command
Default item designations
For the most part, commands that accept item designations default to only act on the top item in the queue. The exceptions are:
list
andmanage
default to handle the entire collectionpop
defaults to pop the last item in the collection to the topactivate
defaults to activateplan
items for today (more on that below)add
adds to the bottom of thetodo
queue
Alternate queues
Busy will manage any number of queues, which are entirely separate sets of items. For example, you might have a shopping
queue for items to buy at the store, and a movies
queue for films you'd like to watch. The default queue is called tasks
.
To designate an alternate queue, use the --queue
or -q
option. For example:
busy add --queue shopping -d "Skimmed Milk"
busy list -q movies
Ready to get busy?
Learn about Filtering and Selection