reports

Three read-only reports over logged time. All of them are gated by the permission to view time tracking entries, and viewing other people’s entries is a separate permission from viewing your own.

Sample responses on this page show the JSON envelope (--json). Pretty output is the default on a terminal and its columns adapt to width. See Output formats.

reports payroll-summary

Per-user working days, present days, and loss-of-pay days for a month.

neetoinvoice reports payroll-summary --month 7 --year 2026

Flag	Type	Required	Default	Description
`--month`	`int`	Yes	`0`	Month number (1-12)
`--year`	`int`	Yes	`0`	Year, e.g. 2026

{
  "data": {
    "month": 7,
    "year": 2026,
    "working_days": 22,
    "rows": [
      {
        "user_name": "Oliver Smith",
        "user_email": "oliver@example.com",
        "working_days": 22,
        "present_days": 21,
        "lop_days": 1
      }
    ]
  }
}

reports timesheet-summary

Per-user, per-day, per-project hours for a date range. Omit --user-email for everyone.

neetoinvoice reports timesheet-summary \
  --start-date 2026-07-01 \
  --end-date 2026-07-07

Flag	Type	Required	Description
`--end-date`	`string`	Yes	Range end (YYYY-MM-DD)
`--start-date`	`string`	Yes	Range start (YYYY-MM-DD)
`--user-email`	`string`	No	Filter to a single user by email

{
  "data": {
    "start_date": "2026-07-01",
    "end_date": "2026-07-07",
    "users": [
      {
        "user_email": "oliver@example.com",
        "user_name": "Oliver Smith",
        "total_hours": 36.5,
        "days": [
          {
            "date": "2026-07-01",
            "entries": [
              {
                "id": "128c1dfc-b29f-4fda-9a05-8a90e197b81b",
                "project_name": "Website Redesign",
                "task_name": "Design",
                "hours": 7.5
              }
            ]
          }
        ]
      }
    ]
  }
}

reports missing-entries

Working days in a range where a user logged nothing. Useful for a weekly nudge.

neetoinvoice reports missing-entries \
  --user-email oliver@example.com \
  --start-date 2026-07-01 \
  --end-date 2026-07-31

Flag	Type	Required	Description
`--end-date`	`string`	Yes	Range end (YYYY-MM-DD)
`--start-date`	`string`	Yes	Range start (YYYY-MM-DD)
`--user-email`	`string`	Yes	User email

{
  "data": {
    "user_email": "oliver@example.com",
    "start_date": "2026-07-01",
    "end_date": "2026-07-31",
    "missing_days": ["2026-07-09", "2026-07-23"],
    "count": 2
  }
}

Pipe it into a script with --quiet:

neetoinvoice reports missing-entries \
  --user-email oliver@example.com \
  --start-date 2026-07-01 \
  --end-date 2026-07-31 \
  --quiet | jq -r '.missing_days[]'

Getting Started

Commands

reports payroll-summary

reports timesheet-summary

reports missing-entries

​reports payroll-summary

​reports timesheet-summary

​reports missing-entries

reports payroll-summary

reports timesheet-summary

reports missing-entries