$idle

Returns your current idle time.

$idle

Note that you cannot echo it yourself; it will be 0 then (as you have just done something).

Example

; you can use it in an on text event
On *:Text:$(* $+ $me $+ *):*: {
 ; lets check if our idle time is greater than 3600 seconds
 if ($idle > 3600) {
   ; we well notice the one who has said our name. Note that /notice doesnt reset our idle time.
   notice $nick I idle for more than one hour, so I'm probably afk.
  }
}