CLI Workflows - Documentation

Common workflows for the Heyweek CLI, built entirely from real commands. Each example combines the timer, project, client, log, and workspace commands into a routine you can run from your terminal.

Daily time tracking

A simple start-to-finish day with the timer:

<span class="token comment"># Make sure your session is valid</span>
hw workspace info

<span class="token comment"># See what (if anything) is currently running</span>
hw timer status

<span class="token comment"># Start tracking your first task</span>
hw timer start <span class="token parameter variable">-d</span> <span class="token string">"Morning standup"</span>

<span class="token comment"># Switch to a new task — force-stops the running timer and starts a new one</span>
hw timer start <span class="token parameter variable">-f</span> <span class="token parameter variable">-d</span> <span class="token string">"Feature work: checkout flow"</span>

<span class="token comment"># Check elapsed time whenever you like</span>
hw timer status

<span class="token comment"># Stop tracking at the end of the task</span>
hw timer stop

Review what you tracked with the log commands:

<span class="token comment"># List recent log entries</span>
hw log list

<span class="token comment"># List more results per page</span>
hw log list <span class="token parameter variable">-L</span> <span class="token number">50</span>

If you forgot to run a timer, add the time after the fact:

hw log create <span class="token parameter variable">-d</span> <span class="token string">"Code review"</span> <span class="token parameter variable">-s</span> <span class="token string">"14:00"</span> <span class="token parameter variable">-e</span> <span class="token string">"15:00"</span>

In this section

Next steps

Learn the basics of time tracking
Organize work with projects and clients