CHS Scripting

CHS is a simple script language that runs Chronos CLI commands line by line. Use it to automate routines, checks, and flows.

Basics

• One command per line, identical to CLI syntax.
• Comments use #.
• Variables expand with @name.

Conditionals

if status:energy eq high then new task "Deep Work" duration:90
if exists note:"Journal" then echo "Journal already exists"
if task:Important:priority >= 8 then mark "Important":next

See Conditions Cookbook for more patterns.

Variables

set var project:"Chronos v1"
new task "Ship @project" priority:high

File/Dir/Env Checks

if exists file:README.md then echo "README found"
if exists dir:User/Tasks then echo "Tasks folder"
if exists env:PATH then echo "PATH exists"

Where Scripts Live

Store scripts under Scripts/. The Listener and Macros can execute them automatically.