From e935eb88830e0b0ddd6830494583a0d2bc64092a Mon Sep 17 00:00:00 2001 From: Hoid Date: Mon, 9 Feb 2026 01:51:36 +0000 Subject: [PATCH] Update TOOLS.md freescout section to match current CLI --- TOOLS.md | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/TOOLS.md b/TOOLS.md index 381434b..4b568ef 100644 --- a/TOOLS.md +++ b/TOOLS.md @@ -184,15 +184,17 @@ Helper script: `~/bin/freescout` freescout mailboxes # List mailboxes freescout users # List users freescout report --from DATE --to DATE # Show time report (tab-separated) - [--mailbox ID] [--user ID] + [--mailbox ID] [--user ID] [--customer NAME] freescout excel --from DATE --to DATE # Generate invoice Excel - [--mailbox ID] [--user ID] [--output file.xlsx] + [--mailbox ID] [--user ID] [--customer NAME] [--output file.xlsx] ``` - Credentials: `.credentials/services.env` (CLOONAR_DB_* + FREESCOUT_DB_NAME) - Queries timelogs table directly (API doesn't expose time tracking) -- Excel groups by conversation, shows subject, customer, hours +- Excel groups by conversation, shows subject, customer, website, hours +- Customer and Website are custom field dropdowns (resolved to labels) - `time_spent` is stored in seconds, displayed as decimal hours +- Only timelogs within the date range are counted (not conversation dates) ---