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.
bash setup.sh
| 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 |
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.
When logging manually, use any of these:
2h = 2 hours90m = 90 minutes1h30m = 1 hour 30 minutes1.5 = 1.5 hoursThis 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
All data stored locally in ~/.nex-timetrack/timetrack.db (SQLite). No cloud, no telemetry.
Override with: export NEX_TIMETRACK_DIR=/custom/path
MIT-0 on ClawHub (free for any use).
AGPL-3.0 on GitHub (commercial licenses via info@nex-ai.be).
共 1 个版本