Documentation

TimerOS documentation

26 articles covering the whole product: getting started and installing the Windows desktop app, short tutorials, the core concepts behind tracked time, running your workspace, and reference material.

Getting started

  • Overview

    TimerOS is a time-management platform for teams and freelancers. What each surface does — the Windows desktop app, web app, admin dashboard and client portal.

  • Install on Windows

    The TimerOS desktop app is the only place your work time is tracked — an always-on-top timer bar plus a dashboard window. Install it on Windows in four steps.

  • Set up your workspace

    Register, pick a plan, then build your structure — departments, roles and invited members — and define the shifts that turn out-of-shift work into overtime.

  • Track your first day

    Your first tracked day starts once onboarding is done and the timer bar is running. How every second is attributed to a state, and how to correct a wrong label.

Tutorials

  • Track your first hours

    Sign in to the Windows desktop app, work as you normally would, and watch the hours land on your dashboard. A two-minute walkthrough of your first tracked time.

  • Check & correct classification

    Open the transparency view in Settings, see why your current activity was labelled productive or idle, and teach the on-device model when it gets one wrong.

  • Add a client & a project

    Create your first client, then a billable project attached to them — name, budget structure, milestones and team — in about two minutes, on any TimerOS plan.

  • Send your first invoice

    Turn tracked work into money: create an invoice for a client, mark it sent so it reaches their portal, and record the payment when it lands. In three minutes.

  • Give a client portal access

    Add a contact to a client record, set their per-area portal permissions, and send the branded invitation that lets them set their own password and sign in.

  • Invite your team

    Send an email invite from the website dashboard, pick a dashboard role and placement, and watch your seat count. Inviting teammates needs Startup or above.

  • Shifts & time off

    Create a shift template, assign it across your team calendar, then follow a time-off request from submission through approval and the leave-balance deduction.

  • Read your week in reports

    Read a week of tracked time: how it split across activity states, where per-project effort and per-client money live, and how to export the week as CSV or PDF.

Core concepts

  • Activity classification

    TimerOS decides productive vs idle on your own device — a scored rule engine first, a small on-device model as fallback. No cloud AI, no LLM, no screenshots.

  • Time states

    Every second the desktop timer runs lands in one of six states — productive, idle, break, overtime, off-work, offline. What each means and how a day is stored.

  • Shifts & leave

    Shifts define when each person is expected to work and shape how time is labelled — productive inside a shift, overtime outside it — and they anchor leave.

  • Projects & tasks

    Projects are how you organise work in TimerOS: milestones, tasks and subtasks, budgets and burn-rate, tracked time, and what clients see in the client portal.

  • Goals & awards

    Company and team goals, an awards leaderboard earned from completed goals on Startup and above, and the personal Achievements page solo Freelancer users get.

Administration

  • Organisation & roles

    Shape your workspace into departments and teams, place people into roles, and control what each person can see and do — with depth of control scaling by plan.

  • Payroll

    Payroll turns assigned shifts and approved leave into salaries, deductions and payslips, per pay period and per team. An Enterprise capability, in early access.

  • Billing & profit

    Bill clients, log expenses, watch profit move in real time and let clients pay invoices online — plus managing your own subscription on the website dashboard.

  • Client portal

    A per-tenant branded web app where your clients sign in to follow projects, pay invoices, raise incidents, approve change requests and accept your notices.

Reference

  • Reports & exports

    TimerOS turns tracked time into per-state breakdowns you can read, compare across periods and export as a CSV or PDF. Reporting is role-aware and plan-aware.

  • Security & privacy

    Per-workspace data isolation, role-based permissions, TOTP two-factor, and on-device activity classification that never sends raw window titles off-device.

  • AI assistant

    Connect Claude to your TimerOS account over one hosted MCP URL. It acts as you, sees only what you see, and every change it makes is logged with its undo call.

  • API reference

    A public API, personal access tokens and webhooks are on the TimerOS roadmap, not yet released. The one shipped integration is the AI assistant connector.

  • Help & support

    Open a support ticket from the dashboard, email support@timeros.ai, or check the changelog, roadmap and status page. Response targets come from our SLA.

Stuck on something not covered here? Email support@timeros.ai.