Commands (Full Reference)

add

Type: Core Commands

Adds an item to a template, intelligently resolving ambiguity.

Usage:
add <item_to_add> to <target_template> [position:<number>]

Adds an item to a template, intelligently resolving ambiguity.
Usage: add <item_to_add> to <target_template> [position:<number>]

aduc

Type: Utilities

Launches ADUC in Chronos mode (Pilot Mode).

Usage:
aduc

Launches ADUC in Chronos mode (Pilot Mode).
Usage: aduc

alarm

Type: Core Commands

Creates an alarm from an item's deadline or due date.

Usage:
alarm from <type> <name> [use:deadline|due_date] [date:YYYY-MM-DD] [time:HH:MM] [message:"..."]

Examples:
alarm from milestone "Finalize docs" use:due_date time:10:00

Creates an alarm from an item's deadline or due date.
Usage: alarm from <type> <name> [use:deadline|due_date] [date:YYYY-MM-DD] [time:HH:MM] [message:"..."]
Example: alarm from milestone "Finalize docs" use:due_date time:10:00
Notes: If no time is provided and the item date has no time, Chronos uses the alarm default time (or 09:00).
Alias: set alarm from <type> <name> ...

alias

Type: Advanced Features

Creates custom command shortcuts.

Usage:
- alias <name> <command>: Create an alias.
- alias list: List all aliases.
- alias remove <name>: Delete an alias.

Creates custom command shortcuts.
Usage:
- alias <name> <command>: Create an alias.
- alias list: List all aliases.
- alias remove <name>: Delete an alias.

append

Type: Core Commands

Appends text to the content of an existing item.

Usage:
append <type> <name> "<text_to_append>" [property_key:property_value ...]

Appends text to the content of an existing item.
Usage: append <type> <name> "<text_to_append>" [property_key:property_value ...]

archive

Type: Utilities

Moves an item to User/Archive.

Usage:
archive <type> <name>

Moves an item to User/Archive.
Usage: archive <type> <name>

backup

Type: Utilities

Creates a zip backup of the User directory.

Usage:
backup

Creates a zip backup of the User directory.
Usage: backup

bulk

Type: Advanced Features

Executes a command on multiple items matching a filter.

Usage:
bulk <command> [args...] [limit:<n>] [dry:true|false]

Examples:
filter task status:pending; bulk delete force:true
filter all; bulk set tag:legacy dry:false

Executes a command on multiple items matching a filter.
Usage: bulk <command> [args...] [limit:<n>] [dry:true|false]
Example: filter task status:pending; bulk delete force:true
Example: filter all; bulk set tag:legacy dry:false

change

Type: Scheduling & Tracking

Changes the start time of an item in the current day's schedule.

Usage:
change <item_name> <new_start_time_HH:MM>

Changes the start time of an item in the current day's schedule.
Usage: change <item_name> <new_start_time_HH:MM>

check

Type: Scheduling & Tracking

Runs a data integrity check on your User directory.

Usage:
check

Runs a data integrity check on your User directory.
Usage: check

clean

Type: Utilities

Removes temporary files.

Usage:
clean

Removes temporary files.
Usage: clean

cls

Type: Utilities

Clears the terminal screen.

Usage:
cls

Clears the terminal screen.
Usage: cls

cmd

Type: Utilities

Executes a Windows CMD command.

Usage:
cmd <command>

Executes a Windows CMD command.
Usage: cmd <command>

commitments

Type: Advanced Features

Evaluates all commitments and fires triggers.

Usage:
commitments [check]

Evaluates all commitments and fires triggers.
Usage: commitments [check]

complete

Type: Scheduling & Tracking

Marks an item as completed.

Usage:
complete <type> <name> [minutes:<duration>]

Marks an item as completed.
Usage: complete <type> <name> [minutes:<duration>]

copy

Type: Core Commands

Creates a duplicate of an existing item, optionally with a new name and modified properties.

Usage:
copy <type> <source_name> [new_name] [property_key:property_value ...]

Creates a duplicate of an existing item, optionally with a new name and modified properties.
Usage: copy <type> <source_name> [new_name] [property_key:property_value ...]

count

Type: Core Commands

Counts items of a specific type, optionally filtered by properties.

Usage:
count <type> [property_key:property_value ...]

Counts items of a specific type, optionally filtered by properties.
Usage: count <type> [property_key:property_value ...]

create

Type: Core Commands

Creates a new item (alias-style alternative to new).

Usage:
create <type> <name> [properties...]

Creates a new item (alias-style alternative to new).
Usage: create <type> <name> [properties...]

cut

Type: Scheduling & Tracking

Removes an item from the current day's schedule.

Usage:
cut <item_name>

Removes an item from the current day's schedule.
Usage: cut <item_name>

dashboard

Type: Advanced Features

Bundles settings and launches the Chronos Dashboard in your browser.

Usage:
dashboard [host:IP] [port:N]

Bundles settings and launches the Chronos Dashboard in your browser.
Usage: dashboard [host:IP] [port:N]

delete

Type: Core Commands

Deletes an item permanently (use archive for soft delete).

Usage:
delete <type> <name>

Deletes an item permanently (use archive for soft delete).
Usage: delete <type> <name>

did

Type: Scheduling & Tracking

Logs actuals for a schedule block.

Usage:
did "Block Name" [start_time:HH:MM] [end_time:HH:MM] [status:completed|skipped|partial] [note:"..."]

Logs actuals for a schedule block.
Usage: did "Block Name" [start_time:HH:MM] [end_time:HH:MM] [status:completed|skipped|partial] [note:"..."]

diff

Type: Utilities

Shows differences between two items or two files.

Usage:
- diff <type> <name1> <name2>
- diff file <path1> <path2>

Shows differences between two items or two files.
Usage:
- diff <type> <name1> <name2>
- diff file <path1> <path2>

dismiss

Type: Reminders & Alarms

Dismisses a specified alarm for the remainder of the current day.

Usage:
dismiss <alarm_name>

Dismisses a specified alarm for the remainder of the current day.
Usage: dismiss <alarm_name>

docs

Type: Utilities

Opens Chronos docs in your default viewer.

Usage:
docs [topic]

Opens Chronos docs in your default viewer.
Usage: docs [topic]

echo

Type: Utilities

Prints text to the console.

Usage:
echo <text_to_print>

Prints text to the console.
Usage: echo <text_to_print>

edit

Type: Core Commands

Opens an item in the default editor (VS Code).

Usage:
edit <type> <name>

Opens an item in the default editor (VS Code).
Usage: edit <type> <name>

export

Type: Utilities

Exports data to YAML or zips the full User directory.

Usage:
- export all [filename.zip]
- export <filename> <command> [args...]

Exports data to YAML or zips the full User directory.
Usage:
- export all [filename.zip]
- export <filename> <command> [args...]

filter

Type: Advanced Features

Sets the active filter for Chronos items.

Usage:
filter <item_type> [property:value ...] | filter all | filter off

Examples:
- filter task status:pending
- filter all
- filter type:all

Sets the active filter for Chronos items.
Usage: filter <item_type> [property:value ...] | filter all | filter off
Examples:
- filter task status:pending
- filter all
- filter type:all

for

Type: Automation & Scripting

Iterates items and runs a command for each.

Usage:
for <var> in <type> [filters] then <command> [args...]

Examples:
for item in tasks status:pending then echo @item
for t in tasks priority:high then set task @t status:next

Iterates items and runs the command for each. Sets @i, @<var>, and @<var>_type.
Usage: for <var> in <type> [filters] then <command> [args...]

find

Type: Core Commands

Searches for items of the specified type based on a keyword and optional properties.

Usage:
find <type> <keyword> [property_key:property_value ...]

Searches for items of the specified type based on a keyword and optional properties.
Usage: find <type> <keyword> [property_key:property_value ...]

get

Type: Core Commands

Retrieves the value of a specific property from an item.

Usage:
get <type> <name> <property_key> [variable_name:<var_name>] [property_key:property_value ...]

Retrieves the value of a specific property from an item.
Usage: get <type> <name> <property_key> [variable_name:<var_name>] [property_key:property_value ...]

help

Type: Core Commands

Displays help information for a command.

Usage:
help <command>

Displays help information for a command.
Usage: help <command>

If

Type: Automation & Scripting

Runs a single-line conditional command.

Usage:
if <left> <op> <right> then <command> [args...] [else <command> ...]

Runs a single-line conditional command.
Usage: if <left> <op> <right> then <command> [args...] [else <command> ...]

import

Type: Utilities

Imports items from YAML or restores a full backup zip.

Usage:
import <file_path>

Imports items from YAML or restores a full backup zip.
Usage: import <file_path>

inventory

Type: Utilities

Manages inventory items.

Usage:
inventory list, inventory add <name>, inventory remove <name>

Manages inventory items.
Usage: inventory list, inventory add <name>, inventory remove <name>

list

Type: Core Commands

Lists items of a specific type.

Usage:
list <type> [filter]

Examples:
- list tasks
- list projects status:active

Lists items of a specific type.
Usage: list <type> [filter]
Example:
- list tasks
- list projects status:active

macro

Type: Advanced Features

Manages automation macros.

Usage:
macro list

Manages automation macros.
Usage: macro list

mark

Type: Scheduling & Tracking

Marks an item in the daily schedule with a new status.

Usage:
mark <item_name>:<status>

Marks an item in the daily schedule with a new status.
Usage: mark <item_name>:<status>

mark_norm

Type: Scheduling & Tracking

Marks an item in the daily schedule with a new status (normalized variant).

Usage:
mark <item_name>:<status>

Marks an item in the daily schedule with a new status (normalized variant).
Usage: mark <item_name>:<status>

miss

Type: Scheduling & Tracking

Records a missed occurrence (does not count as completion).

Usage:
miss <type> <name>

Records a missed occurrence (does not count as completion).
Usage: miss <type> <name>

move

Type: Core Commands

Moves an item to a new item type, renames it, or both.

Usage:
move <source_type> <source_name> [new_name] [type:<target_type>] [name:<new_name>] [property_key:property_value ...]

Moves an item to a new item type, renames it, or both.
Usage: move <source_type> <source_name> [new_name] [type:<target_type>] [name:<new_name>] [property_key:property_value ...]

new

Type: Core Commands

Creates a new item.

Usage:
new <type> <name> [properties...]

Examples:
new task "Finish Report" due:today priority:high

Creates a new item.
Usage: new <type> <name> [properties...]
Example: new task "Finish Report" due:today priority:high

next

Type: Scheduling & Tracking

Previews a future schedule beyond tomorrow.

Usage:
next day|<weekday>|<ordinal> [of] <month>

Previews a future schedule beyond tomorrow.
Usage: next day|<weekday>|<ordinal> [of] <month>

pause

Type: Automation & Scripting

Pauses script execution until a key is pressed.

Usage:
pause [message]

Pauses script execution until a key is pressed.
Usage: pause [message]

points

Type: Rewards & Points

Manages the points ledger.

Usage:
- points balance
- points add <n> [reason:<text>]
- points subtract <n> [reason:<text>]
- points history [<last_N>]

Manages the points ledger.
Usage:
- points balance
- points add <n> [reason:<text>]
- points subtract <n> [reason:<text>]
- points history [<last_N>]

powershell

Type: Utilities

Executes PowerShell code.

Usage:
powershell <powershell_code>

Executes PowerShell code.
Usage: powershell <powershell_code>

profile

Type: Utilities

Shows profile details.

Usage:
profile show

Shows profile details.
Usage: profile show

register

Type: Utilities

Builds command, item, and property registries for autosuggest.

Usage:
register commands|items|properties|all

Builds JSON registries under Registry/ used by autosuggest and tooling.
Usage: register commands|items|properties|all

repeat

Type: Automation & Scripting

Runs a single command N times.

Usage:
repeat count:<n> then <command> [args...]

Examples:
repeat count:3 then echo Pass @i
repeat count:5 then new note "Loop @i" category:work

Runs a single command N times. Sets @i each iteration (1-based).
Usage: repeat count:<n> then <command> [args...]

redeem

Type: Rewards & Points

Redeems a reward and applies its target.

Usage:
redeem reward <name>

Redeems a reward and applies its target.
Usage: redeem reward <name>

reminder

Type: Core Commands

Creates a reminder from an item's deadline or due date.

Usage:
reminder from <type> <name> [use:deadline|due_date] [date:YYYY-MM-DD] [time:HH:MM] [message:"..."]

Examples:
reminder from task "Ship v1" use:deadline time:09:00

Creates a reminder from an item's deadline or due date.
Usage: reminder from <type> <name> [use:deadline|due_date] [date:YYYY-MM-DD] [time:HH:MM] [message:"..."]
Example: reminder from task "Ship v1" use:deadline time:09:00
Notes: If no time is provided and the item date has no time, Chronos uses the reminder default time (or 09:00).
Alias: set reminder from <type> <name> ...

remove

Type: Core Commands

Removes a specified property from an item.

Usage:
remove <type> <name> <property_key>

Removes a specified property from an item.
Usage: remove <type> <name> <property_key>

rename

Type: Core Commands

Renames an existing item.

Usage:
rename <type> <old_name> <new_name> [properties]

Renames an existing item.
Usage: rename <type> <old_name> <new_name> [properties]

restore

Type: Utilities

Restores the User directory from a backup zip.

Usage:
restore <filename|latest> [force:true]

Restores the User directory from a backup zip.
Usage: restore <filename|latest> [force:true]

review

Type: Advanced Features

Generates periodic reviews (Daily, Weekly, Monthly).

Usage:
- review daily [YYYY-MM-DD]
- review weekly [YYYY-WW]
- review monthly [YYYY-MM]
- review export ...: Exports the review to Markdown.

Generates periodic reviews (Daily, Weekly, Monthly).
Usage:
- review daily [YYYY-MM-DD]
- review weekly [YYYY-WW]
- review monthly [YYYY-MM]
- review export ...: Exports the review to Markdown.

run

Type: Automation & Scripting

Executes a Chronos script (.chs).

Usage:
run <script_file>

Executes a Chronos script (.chs).
Usage: run <script_file>

search

Type: Utilities

Searches for text content across all items.

Usage:
search <query>

Searches for text content across all items.
Usage: search <query>

sequence

Type: Advanced Features

Manages the data mirroring and trends system.

Usage:
- sequence status: Show registry of SQLite mirrors.
- sequence sync: Run the builders to update mirrors.
- sequence trends: Generate the trends report.

Manages the data mirroring and trends system.
Usage:
- sequence status: Show registry of SQLite mirrors.
- sequence sync: Run the builders to update mirrors.
- sequence trends: Generate the trends report.

set

Type: Core Commands

Sets properties of an item or defines a script variable.

Usage:
set <type> <name> <property_key>:<value> [...]

Sets properties of an item or defines a script variable.
Usage: set <type> <name> <property_key>:<value> [...]

settings

Type: Utilities

Quick access to open settings files.

Usage:
settings <name> (e.g., settings theme)

Quick access to open settings files.
Usage: settings <name> (e.g., settings theme)

skip

Type: Reminders & Alarms

Skips a specified alarm for the remainder of the current day.

Usage:
skip <alarm_name>

Skips a specified alarm for the remainder of the current day.
Usage: skip <alarm_name>

snooze

Type: Reminders & Alarms

Snoozes a specified alarm for its configured snooze duration.

Usage:
snooze <alarm_name>

Snoozes a specified alarm for its configured snooze duration.
Usage: snooze <alarm_name>

start

Type: Scheduling & Tracking

Rebuilds today's schedule and starts a timer sequence of the remaining blocks.

Usage:
- start day
- start today

Rebuilds today's schedule and starts a timer sequence of the remaining blocks.
Usage:
- start day
- start today

status

Type: Scheduling & Tracking

Views or sets user status variables.

Usage:
- status
- status <indicator>:<value>

Views or sets user status variables.
Usage:
- status
- status <indicator>:<value>

theme

Type: Utilities

Lists, shows, or sets console themes and colors.

Usage:
theme <subcommand>

Lists, shows, or sets console themes and colors.
Usage: theme <subcommand>

this

Type: Scheduling & Tracking

Previews the nearest occurrence of a weekday in the current week.

Usage:
this <weekday>

Previews the nearest occurrence of a weekday in the current week.
Usage: this <weekday>

timer

Type: Scheduling & Tracking

Manages the countdown timer.

Usage:
- timer start <profile> [type:<item_type> name:<item_name>] [cycles:N] [auto_advance:true|false]
- timer pause | resume | stop | status
- timer confirm yes|no
- timer profiles list | view <name> | save <name> [k:v ...] | delete <name>

Manages the countdown timer.
Usage:
- timer start <profile> [type:<item_type> name:<item_name>] [cycles:N] [auto_advance:true|false]
- timer pause | resume | stop | status
- timer confirm yes|no
- timer profiles list | view <name> | save <name> [k:v ...] | delete <name>

today

Type: Scheduling & Tracking

The central command for daily management.

The central command for daily management.
Subcommands:
- today: Shows today's schedule (in-progress and upcoming).
- today reschedule: Rebuilds the schedule with conflict resolution.
- today routines|subroutines|microroutines: Collapses display to that level.

tomorrow

Type: Scheduling & Tracking

Previews the schedule for tomorrow (or a specified offset).

Usage:
tomorrow [days:<n>]

Previews the schedule for tomorrow (or a specified offset).
Usage: tomorrow [days:<n>]

track

Type: Scheduling & Tracking

Logs time spent on an activity.

Usage:
track <task_name> <duration>

Logs time spent on an activity.
Usage: track <task_name> <duration>

tree

Type: Advanced Features

Visualizes item hierarchy or directory structure.

Usage:
- tree <type> <name>
- tree dir <path>

Visualizes item hierarchy or directory structure.
Usage:
- tree <type> <name>
- tree dir <path>

trim

Type: Scheduling & Tracking

Reduces the duration of an item in the current day's schedule.

Usage:
trim <item_name> <amount_in_minutes>

Reduces the duration of an item in the current day's schedule.
Usage: trim <item_name> <amount_in_minutes>

undo

Type: Utilities

Restores the most recently archived item or schedule.

Usage:
- undo delete [type]
- undo reschedule

Restores the most recently archived item or schedule.
Usage:
- undo delete [type]
- undo reschedule

unset

Type: Automation & Scripting

Removes a script variable from the current session.

Usage:
unset var <name>

Removes a script variable from the current session.
Usage: unset var <name>

vars

Type: Automation & Scripting

Lists current script variables or a single variable by name.

Usage:
vars [name:<varname>]

Lists current script variables or a single variable by name.
Usage: vars [name:<varname>]

view

Type: Core Commands

Displays the contents of an item in the terminal.

Usage:
view <type> <name>

Displays the contents of an item in the terminal.
Usage: view <type> <name>

while

Type: Automation & Scripting

Runs a command while a condition is true, bounded by max iterations.

Usage:
while <condition> max:<n> then <command> [args...]

Examples:
while status:energy eq high max:3 then echo Still going @i
while exists task:"Draft" max:5 then echo Draft exists

Runs a command while the condition is true, stopping after max iterations. Sets @i.
Usage: while <condition> max:<n> then <command> [args...]