- Home
- Skills
- Productivity
- freelance-timer
Works with the AI Agents you already use
Freelance Timer
An agentic skill that keeps an honest per-client, per-project ledger of hours, estimated tokens and costs, with an invoice-ready HTML dashboard.
$9
freelance-timer
Example session with this skill installed
show me my dashboard and tell me how much I can invoice per client
- Read your context and instructions
- Compiled the freelance-timer
Dashboard generated. Invoiceable (billable only, cost + additionals): Acme 95.00 USD + 10.00 EUR; Beta 80.00 EUR. 0.25 h of non-billable work is not invoiced. Currencies are listed separately, never summed.
Connects securely to your tools. The creator never sees your data.
About this skill
The user is a freelancer who bills clients by the hour. This skill produces an honest ledger of what each session cost, per client and project, so invoices can be built from it. Accuracy matters more than speed: a wrong billable flag becomes a wrong invoice, which is why the topic-change check below asks instead of guessing.
All state is handled by scripts/ft.py (path relative to this skill; call it with python3). Data lives in ~/.claude/freelance-timer/, one global place, so the dashboard can aggregate every client no matter which directory the session ran in. Never edit those files by hand.
- Run
python3 scripts/ft.py projectsto list known projects and their rates. - Ask the user, in one message, which client and project this session is for (offer the known ones) and whether it is billable. If the answer is already in the opening message, skip the question and confirm in a sentence.
- For a new project, ask for the hourly rate and currency now (both are required, because every cost is reported in the project's own currency), then save it:
python3 scripts/ft.py setup --client C --project P --rate 40 --currency USD --billable yesThe rate is set once per project and reused; only ask again if the user wants to change it. - Open the session:
python3 scripts/ft.py begin --client C --project P --billable yes|nobeginprints asessionid. Remember it and pass--session IDto every latertick,close,endandstatuscall: each session keeps its own state, so several Claude sessions in the same directory no longer overwrite each other. Ifbeginrefuses because an earlier session left an interaction open (it lists session id, topic and minutes), ask the user whether that work was billable, runpython3 scripts/ft.py close --billable yes|no --session OLD_ID --note "..."(omit--sessionwhen the list says so), then runbeginagain. Never use--discardunless the user says to throw that time away.
If the user says the session is not for client work at all, run begin with --billable no on a project named for what it is (e.g. client "internal") so the time is still visible.
Token counts are estimates (the agent cannot see exact usage). Amounts are only as accurate as the billable flags you confirm. Currencies are never converted or summed; totals are listed per currency. Automatic start each session needs a SessionStart hook, and hooks must be enabled.
How to use
- 1
Connect your agent to the Agensi MCP
Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup
- 2
Sign in to Agensi
Your agent shows a sign-in link. Sign in and click Allow.
- 3
Ask for what you need
Your agent loads this skill and uses it on your task. It always asks before any payment.
Reviews
No reviews yet
Be one of the first to try it. Every listed skill goes through the trust checks below.
Security scanned
Checked by our 8-point scan before listing
Fresh listing
Recently published to Agensi
Money-back guarantee
Doesn't do what its page promises? You get your money back.
Trust & safety
Security scan
Security scan passed 5 days ago
Requires
Permissions
File Scopes
Standard-library Python only, no network access. The dashboard command opens the generated local HTML file in the default browser.