Add FreeScout time tracking CLI with Excel invoice generation

This commit is contained in:
Hoid 2026-02-09 01:20:34 +00:00
parent 88229d7e5e
commit 749ee04ed7
6 changed files with 1406 additions and 0 deletions

View file

@ -176,6 +176,26 @@ ainews reset # Clear seen history
---
## FreeScout Time Tracking
Helper script: `~/bin/freescout`
```bash
freescout mailboxes # List mailboxes
freescout users # List users
freescout report --from DATE --to DATE # Show time report (tab-separated)
[--mailbox ID] [--user ID]
freescout excel --from DATE --to DATE # Generate invoice Excel
[--mailbox ID] [--user ID] [--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
- `time_spent` is stored in seconds, displayed as decimal hours
---
## Brain Dump CLI
Helper script: `~/clawd/bin/tasks`