Skip to main content

Edit Command

View the output of tt edit --help

track-time-cli edit [description..]

View, edit, or delete a time sheet entry

Options:
--version Show version number [boolean]
-s, --sheet Name of time sheet to edit [string]
-n, --name New name to apply to specified time sheet [string]
-e, --entry ID of entry to edit [number]
--description New description for the specified entry [string]
-d, --delete, --del Delete the specified time sheet or time sheet entry
[boolean]
--help Show help [boolean]

The edit command is used to edit or delete time sheets and time sheet entries.

Select a time sheet by name with the --sheet argument, or a time sheet entry by ID with the --entry argument.

note

If you omit --sheet and use --entry, the active time sheet will be selected by default.

Time sheet name and sheet entry description can be set via the --name and --description arguments, respectively.

To delete, select a time sheet or entry and pass --delete.

tip

The edit command has an alias: e

Arguments

warning

Deleted items are lost forever.

argumentaliastypedescriptiondefault
--sheet-sstringName of time sheet to edit
--entry-estringID of entry to edit
--name-nstringNew name to apply to the specified time sheetfalse
--descriptionstringNew description for the specified entryfalse
--delete-d, --delbooleanDelete the specified time sheet or time sheet entryfalse

Examples

Examples of editing and deleting sheets and entries are provided below.

Editing A Time Sheet Name

To edit a time sheet, select it with the --sheet argument and provide a new name with the --name argument: Output of tt e --sheet main --name new-main

Editing An Entry Description

To edit an entry's description, select it with the --entry argument and provide a new description with the --description argument: Output of tt e --entry 1 --description "updated description"

Deleting A Time Sheet

To delete a time sheet, select it with the --sheet argument and pass --delete: Output of tt e --sheet main --delete

Deleting An Entry

To delete an entry, select it with the --entry argument and pass --delete: Output of tt e --entry 1 --delete