Works with the AI Agents you already use

    Claude CodeClaude CodeCursorCursorCodex CLICodex CLIMuseMuseDotsDots+21 more

    Freelance Timer

    1

    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

    Secure checkout via Stripe

    Money-back guarantee

    Converts to your local currency at checkout

    Security scanned
    freelance-timer

    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.

    1. Run python3 scripts/ft.py projects to list known projects and their rates.
    2. 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.
    3. 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 yes The rate is set once per project and reused; only ask again if the user wants to change it.
    4. Open the session: python3 scripts/ft.py begin --client C --project P --billable yes|no begin prints a session id. Remember it and pass --session ID to every later tick, close, end and status call: each session keeps its own state, so several Claude sessions in the same directory no longer overwrite each other. If begin refuses because an earlier session left an interaction open (it lists session id, topic and minutes), ask the user whether that work was billable, run python3 scripts/ft.py close --billable yes|no --session OLD_ID --note "..." (omit --session when the list says so), then run begin again. Never use --discard unless 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. 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. 2

      Sign in to Agensi

      Your agent shows a sign-in link. Sign in and click Allow.

    3. 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

    Python 3

    Permissions

    File Scopes

    ~/.claude/freelance-timer/
    (read/write:
    config
    ledger
    session
    state
    dashboard.html)

    Standard-library Python only, no network access. The dashboard command opens the generated local HTML file in the default browser.

    Listed5 days ago

    What's inside

    Frequently Asked Questions

    An agentic skill that keeps an honest per-client, per-project ledger of hours, estimated tokens and costs, with an invoice-ready HTML dashboard.

    This skill uses the open SKILL.md standard. Use it through an MCP-compatible agent connected to Agensi, and check the compatibility information on this page for confirmed agents and required capabilities.

    Connect your AI agent to Agensi through MCP, then ask it to use freelance-timer on your task. Your agent loads the latest approved version each time. Paid skills require a purchase or active subscription. Skill files are not available for download; your licence does not allow you to save, copy or export any part of a skill.

    New in Productivity