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
- Python 3.8+
- No external dependencies (stdlib only)
- SQLite (built into Python)
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 hours
Tone 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).