Command Reference
Status: Early development — this list reflects current commands detected in the repo. Developer: David Cody.
Chronos CLI commands in concise form. Arguments in [square brackets] are optional.
add <item> to <target> [position:<number>]
Adds an item to a template’s sub‑items.
append <type> <name> "text"
Appends text to an item’s content.
change <name> <HH:MM>
Changes an item’s start time in today’s schedule.
cls
Clears the terminal screen.
cmd <command>
Executes a command‑line command.
complete
Completes items based on context (when enabled).
copy <type> <source> [new]
Duplicates an existing item.
count <type> [prop:value ...]
Counts items, optionally filtered.
create|new <type> <name> [prop:value ...]
Creates a new item.
cut <name>
Removes an item from today’s schedule.
dashboard
Opens the Chronos web dashboard.
delete [-f|--force] <type> <name>
Deletes an item.
dismiss|skip|snooze <alarm_name>
Manages alarms for the current day.
echo "text"
Prints text to the console.
edit <type> <name> [editor:<name>]
Opens an item in an editor.
export
Exports data (when configured).
filter <type> [prop:value ...] | filter all | filter off
Sets or clears the active item filter.
find <type> <keyword> [prop:value ...]
Searches for items.
get <type> <name> <property>
Retrieves a specific property value.
get <type> <name> <property>
Retrieves a specific property value.
help [command]
Shows help for the CLI or a specific command.
import
Imports data/items (when configured).
list <type> [sort_by:<key>] [reverse_sort:True|False]
Lists items with sorting options.
mark <name>:<status>
Marks an item in the daily schedule with a status.
mark_norm
Normalizes marks/status for items where supported.
miss
Manages or lists missed alarms/slots (when available).
move <src_type> <src_name> [new] [type:<dst_type>]
Moves and/or renames an item.
pause [message]
Pauses script execution.
powershell <code>
Runs PowerShell code.
remove <type> <name> <property>
Removes a property from an item.
rename <type> <old> <new>
Renames an item.
set <type> <name> <key>:<value> [...]
Sets one or more properties.
settings <file_shortcut> <property> <value>
Modifies a setting.
status [type:value]
Views or sets status variables.
today [reschedule]
Displays or regenerates today’s schedule.
track
Starts/stops tracking utilities (where available).
trim <name> <minutes>
Reduces an item’s duration today.
view <type> <name>
Displays an item’s content and properties.