Command Reference

List of Commands

Commands:
  adjust    📝 Adjust the details of an activity, such as its category, description, or tags [aliases: a]
  begin     ⌚ Starts tracking time for an activity [aliases: b]
  end       ⏹️ Stops time tracking for the most recent or all activities [aliases: e]
  hold      ⏸️ Pauses the time tracking for the most recent active activity [aliases: h]
  now       ⏲️ Shows you at a glance what you're currently tracking [aliases: n]
  resume    ⏯️ Resumes a previously paused activity, allowing you to continue where you left off [aliases: r]
  reflect   📈 Get sophisticated insights on your activities [aliases: rev]
  setup     🛠️ Set up a pace configuration, a new project, or generate shell completions [aliases: s]
  settings  ⚙️ Changes various application settings, including Pomodoro lengths, time zone, and reflection format [aliases: s]
  docs      📚 Open the online documentation for pace [aliases: d]
  help      Print this message or the help of the given subcommand(s)

Command Descriptions

adjust

Adjust the current activity’s start time, description, category, or tags. This is useful for correcting mistakes or adding more detail to your activities.

Usage: pace adjust --category <Category> --description <Description> --start <Start Time>

begin

Starts tracking time for the specified task. You can optionally specify a category or project to help organize your tasks.

Usage: pace begin "Design Work" --category "Freelance" --start 10:00

end

Stops time tracking for all tasks, marking them as completed or finished for the day.

Usage: pace end --end 11:30

hold

Pauses the time tracking for the specified task. This is useful for taking breaks without ending the task.

Usage: pace hold --reason <Reason>

now

Displays the currently running task, showing you at a glance what you’re currently tracking.

Usage: pace now

resume

Resumes time tracking for a previously paused task, allowing you to continue where you left off.

Usage: pace resume or pace resume --list

reflect

Gain insight in your activities and tasks. You can specify the time frame for daily, weekly, or monthly insights.

Usage: pace reflect --last-week or pace reflect --from 2024-02-10 --to 2024-03-06 or pace reflect --today -o json -e ./data/data.json

setup

Create configuration files for pace, including the main configuration file and any additional settings. This is useful for setting up pace for the first time or when you need to change your settings. You can also generate shell completions for your shell of choice. And generate a project configuration file.

Usage: pace setup config or pace setup completions

settings

Change various application settings, including Pomodoro lengths, time zone, and reflection format. This is useful for customizing pace to your preferences. You can also get the current settings for the application, e.g. for automation.

Usage: pace settings set time-zone or pace settings get time-zone

docs

Opens the documentations for users, developers, and the configuration file in your default browser.

Usage: pace docs or pace docs --dev or pace docs --config

help

Prints a help message or the help of the given subcommand(s).

Usage: pace help or pace help begin or pace help adjust

Options and Flags

Only available on begin, end, hold, resume, adjust

  • –time-zone: Specifies the time zone for the activity.

    Usage: --time-zone "America/New_York" or --time-zone "Europe/Berlin"

  • –time-zone-offset: Specifies the time zone offset for the activity. The offset should be in the format ±HHMM.

    Usage: --time-zone-offset="+0530" or --time-zone-offset="-0800"

    Note: This flag is mutually exclusive with --time-zone. If both are provided, --time-zone will take precedence. You also need to use the --time-zone-offset flag with the equal sign.

Only available on adjust

  • –override-tags: Overrides the current tags with the specified tags.

    Usage: --override-tags "design,assets" or --override-tags "design,assets,client-x"

  • –start: Specifies the start time of the activity.

    Usage: --start 10:00 or --start 10:00:00

adjust, begin, end, hold, resume

  • –category: Specifies the category of the activity.

    Usage: --category "Freelance" or --category "Freelance::Design"

  • –description: Specifies the description of the activity.

    Usage: --description "Design Work" or --description "Design Work for Client X"

  • –at: Specifies the start, end or resuming time of the activity.

    Usage: --at 10:00 or --at 10:00:00

  • –tags: Specifies the tags for the activity, they will be deduplicated.

    Usage: --tags "design,assets" or --tags "design,assets,client-x"

Only available on resume

  • –reason: Specifies the reason for holding the activity.

    Usage: --reason "Lunch Break" or --reason "Meeting"

  • –list: Lists all activities that are resumable.

    Usage: --list

Only available on reflect

Options:
  -a, --activity-kind <Activity Kind>  Filter by activity kind (e.g., activity, task)
  -c, --category <Category>            Filter by category name, wildcard supported
      --case-sensitive                 Case sensitive category filter
  -o, --output-format <Output Format>  Specify output format (e.g., text, markdown, pdf) [possible values: console, json, html, csv, markdown, plain-text]
  -e, --export-file <Export File>      Export the reflection report to a specified file
  -h, --help                           Print help
  -V, --version                        Print version

Flags for specifying time periods:
      --today          Show the reflection for the current day
      --yesterday      Show the reflection for the previous day
      --current-week   Show the reflection for the current week
      --last-week      Show the reflection for the previous week
      --current-month  Show the reflection for the current month
      --last-month     Show the reflection for the previous month

Date flags for specifying custom date ranges or specific dates:
      --date <Specific Date>  Show the reflection for a specific date, mutually exclusive with `from` and `to`. Format: YYYY-MM-DD
      --from <Start Date>     Start date for the reflection period. Format: YYYY-MM-DD
      --to <End Date>         End date for the reflection period. Format: YYYY-MM-DD

Expensive flags for detailed insights:
      --detailed         Include detailed time logs in the reflection
      --comparative      Enable comparative insights against a previous period
      --recommendations  Enable personalized recommendations based on reflection data

Only available on docs

  • –dev: Opens the developer documentation.

    Usage: --dev

  • –config: Opens the configuration documentation.

    Usage: --config

Usage Syntax

adjust

Usage: pace adjust <--category <Category>|--description <Description>|--start <Start Time>|--tags <Tags>|--override-tags>

begin

Usage: pace begin [OPTIONS] <Activity Description>

end

Usage: pace end [OPTIONS]

hold

Usage: pace hold [OPTIONS]

now

Usage: pace now

resume

Usage: pace resume [OPTIONS]

reflect

pace reflect [OPTIONS]

setup

Usage: pace setup <config|completions|show>

docs

Usage: pace docs [--dev|--config]

help

Usage: pace help [COMMAND]
Last change: 2024-03-24, commit: f01446e