openclawd/config
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Move FreeScout docs from TOOLS.md into invoice-generator skill

Browse source
This commit is contained in:
Hoid 2026-02-09 01:53:40 +00:00
parent e935eb8883
commit ffd01c23bd
2 changed files with 19 additions and 37 deletions
Download patch file Download diff file Expand all files Collapse all files

22
TOOLS.md
View file

@ -176,28 +176,6 @@ 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] [--customer NAME]
freescout excel --from DATE --to DATE # Generate invoice Excel
[--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, 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)
---
## Brain Dump CLI ## Brain Dump CLI
Helper script: `~/clawd/bin/tasks` Helper script: `~/clawd/bin/tasks`

34
skills/invoice-generator/SKILL.md
View file

@ -14,22 +14,26 @@ Generate Excel invoices from FreeScout time tracking data and send them via What
3. Send the file to the user via the `message` tool 3. Send the file to the user via the `message` tool
4. Reply with NO_REPLY (the file message is the reply) 4. Reply with NO_REPLY (the file message is the reply)
## Available customers ## CLI Reference
If unsure which customer, run `bin/freescout report --from 2024-01-01 --to 2099-12-31` to see all, or pass a wrong name — the script prints available customers. ```bash
freescout mailboxes # List mailboxes
## Other commands freescout users # List users
freescout report --from DATE --to DATE # Show time report (tab-separated)
``` [--mailbox ID] [--user ID] [--customer NAME]
bin/freescout mailboxes # List mailboxes freescout excel --from DATE --to DATE # Generate invoice Excel
bin/freescout users # List users [--mailbox ID] [--user ID] [--customer NAME] [--output file.xlsx]
bin/freescout report --from --to # Terminal report (add --customer, --mailbox, --user)
bin/freescout excel --from --to # Excel generation (add --customer, --mailbox, --user, --output)
``` ```
## Notes ## Technical Details
- `time_spent` in DB is seconds, displayed as decimal hours - Credentials: `.credentials/services.env` (CLOONAR_DB_* + FREESCOUT_DB_NAME)
- Excel groups by conversation: subject, customer, website, total hours - Queries timelogs table directly (API doesn't expose time tracking)
- Customer and Website come from FreeScout custom fields (dropdowns) - Excel groups by conversation, shows subject, customer, website, hours
- Only timelogs within the date range are counted, not conversation creation dates - 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)
## Finding Customers
Pass a wrong `--customer` name — the script prints all available customers.