Nex Timetrack
by @nexaiguy
Billable time logger for freelancers and agencies. Start/stop timers or log manually. Client and project management, rate cascading, 15-minute rounding, bill...
clawhub install nex-timetrackπ About This Skill
name: Nex Timetrack description: Billable time logger for freelancers and agencies. Start/stop timers or log manually. Client and project management, rate cascading, 15-minute rounding, billing summaries, full-text search, CSV/JSON export. Python stdlib only, SQLite storage. version: 1.0.0 metadata: author: Nex AI (Kevin Blancaflor) license: MIT-0 website: https://nex-ai.be clawdbot: keywords: - time tracking - billable hours - timesheet - timer - stopwatch - freelancer - agency - invoicing - billing - hourly rate - project time - client hours - urenregistratie - tijdregistratie - facturatie - freelancer uren triggers: - track time - log hours - start timer - billable hours - time entry - how long did I work - client billing - project hours - timesheet - invoice summary - uren bijhouden - tijd loggen - factureerbare uren
Nex Timetrack
Billable time logger built for freelancers and agencies. Track time with a live timer or log entries manually. Manage clients, projects, and rates. Generate billing summaries with optional 15-minute rounding.
Requirements
Setup
bash setup.sh
Commands
| Command | What it does |
|---------|-------------|
| start | Start a live timer |
| stop | Stop timer and save entry |
| status | Show running timer |
| cancel | Cancel timer without saving |
| log | Log time manually |
| show | Show entry details |
| list | List entries with filters |
| edit | Edit an entry |
| delete | Delete an entry |
| search | Full-text search entries |
| client-add | Add a client with rate |
| clients | List all clients |
| project-add | Add a project |
| projects | List all projects |
| summary | Billing summary with totals |
| stats | Usage statistics |
| export | Export to JSON or CSV |
Rate Cascade
Rates resolve in this order: entry rate > project rate > client rate > default (85 EUR/h). Set rates at whatever level makes sense for your billing.
Duration Format
When logging manually, use any of these:
2h = 2 hours90m = 90 minutes1h30m = 1 hour 30 minutes1.5 = 1.5 hoursTone Guide
This skill responds to natural language through ClawdBot. Example interactions:
Starting a timer: > "Start tracking time for the Bakkerij Peeters redesign"
nex-timetrack start "Bakkerij Peeters redesign" --client "Bakkerij Peeters" --category development
Logging time manually: > "Log 2 hours of design work for Lux Interiors yesterday"
nex-timetrack log "Homepage design" 2h --client "Lux Interiors" --category design --date 2026-04-05
Stopping the timer: > "Stop the timer, I finished the API integration"
nex-timetrack stop --notes "Completed API integration for payment flow"
Checking what's running: > "Is my timer running?"
nex-timetrack status
Billing summary for a client: > "How many hours did I bill Bakkerij Peeters this month?"
nex-timetrack summary --client "Bakkerij Peeters" --date-from 2026-04-01 --round-up
Weekly overview: > "Show me this week's time entries"
nex-timetrack list --date-from 2026-03-31 --date-to 2026-04-06
Adding a client: > "Add Bakkerij Peeters as a client at 95 per hour"
nex-timetrack client-add "Bakkerij Peeters" --rate 95 --email "jan@bakkerijpeeters.be"
Export for invoicing: > "Export all billable hours for Lux Interiors as CSV"
nex-timetrack export csv --client "Lux Interiors" --billable
Storage
All data stored locally in ~/.nex-timetrack/timetrack.db (SQLite). No cloud, no telemetry.
Override with: export NEX_TIMETRACK_DIR=/custom/path
License
MIT-0 on ClawHub (free for any use). AGPL-3.0 on GitHub (commercial licenses via info@nex-ai.be).
βοΈ Configuration
bash setup.sh