Configuration

Hourgit uses a schedule system to define working hours. The factory default is Monday-Friday, 9 AM - 5 PM.

Schedule Types

The interactive schedule editor (project schedule set / defaults schedule set) supports three schedule types:

• Recurring — repeats on a regular pattern (e.g., every weekday, every Monday/Wednesday/Friday)
• One-off — applies to a single specific date (e.g., a holiday or overtime day)
• Date range — applies to a contiguous range of dates (e.g., a week with different hours)

Each schedule entry defines one or more time ranges for the days it covers. Multiple entries can be combined to build complex schedules.

Per-Project Overrides

Every project starts with a copy of the defaults. You can then customize a project's schedule independently:

# View current schedule
hourgit project schedule get --project 'My Project'

# Edit schedule interactively
hourgit project schedule set --project 'My Project'

# Revert to defaults
hourgit project schedule reset --project 'My Project'

# See expanded hours for a month
hourgit project schedule report --project 'My Project' --month 3

Precise Mode

By default, Hourgit attributes all time between branch checkouts (within your schedule) as work. Precise mode adds filesystem-level idle detection: a background daemon watches your repository for file changes and records when you stop and resume working. Idle gaps are automatically trimmed from checkout sessions at report time.

Enable precise mode during init or project creation:

hourgit init --mode precise
hourgit project add myproject --mode precise

The idle threshold defaults to 10 minutes — after 10 minutes of no file changes, the daemon records an idle stop. When precise mode is enabled, Hourgit auto-installs a user-level OS service to run the watcher daemon.

Editing Defaults

Changes to defaults only affect newly created projects. Existing projects keep their current schedule.

# View defaults
hourgit defaults schedule get

# Edit defaults
hourgit defaults schedule set

# Reset to factory (Mon-Fri, 9-5)
hourgit defaults schedule reset