TimerOS documentation

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

The desktop app, with its timer bar and dashboard window, is the only place TimerOS tracks your work time. Install it on Windows in four steps.

Register, pick a plan, then add departments, roles and members, and define the shifts that decide when work counts as overtime.

Your first tracked day starts once onboarding is done and the timer bar is running. See how each second gets a state and how to fix a wrong label.

Sign in to the Windows desktop app, work as usual, and see the hours appear on your dashboard. It takes about two minutes.

Open Settings, see why your current activity was labelled productive or idle, and correct the on-device model when it gets a label wrong.

Create your first client, then a billable project for them with a name, budget structure, milestones and team. Any plan works, and it takes about two minutes.

Create an invoice for a client, mark it as sent so it appears in their portal, and record the payment when it arrives. It takes about three minutes.

Add a contact to a client, set what they can see and do in the portal, and send the branded invitation they use to set a password and sign in.

Send an email invite from the website dashboard, choose a dashboard role and team, and check your seat count. Inviting teammates requires the Startup plan or above.

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

See how a week of tracked time splits across activity states, where to find hours per project and revenue per client, and how to export the week as CSV or PDF.

TimerOS labels activity productive or idle on your computer: a rule engine first, then a small on-device model when the rules can’t decide. No cloud AI, no LLM, no screenshots.

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

Shifts set when each person is expected to work and how time is labelled: productive inside a shift, overtime outside it. Leave is planned around them too.

How projects organise work in TimerOS: milestones, tasks and subtasks, budgets, tracked time, and what clients see in the client portal.

Startup and above include company and team goals and an awards leaderboard earned from completed goals. Freelancer users get a personal Achievements page.

Organise your workspace into departments and teams, give people roles, and control what each person can see and do. Higher plans give you more control.

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

Bill clients, log expenses, follow profit in real time and let clients pay invoices online. You’ll also see how to manage your own subscription on the website dashboard.

A web app with your branding where your clients sign in to follow projects, pay invoices, report incidents, approve change requests and accept your notices.

TimerOS breaks your tracked time down by state, so you can compare periods and export it as CSV or PDF. What you see depends on your role and plan.

Separate data for each workspace, role-based permissions, TOTP two-factor sign-in, and on-device activity classification that never sends raw window titles anywhere.

Connect Claude to your TimerOS account with one hosted MCP address. It acts as you, sees only what you see, and every change it makes is logged with the call that undoes it.

A public API, personal access tokens and webhooks aren’t available and aren’t on the TimerOS roadmap right now. There are two integrations: the AI assistant connector and a GitHub connection for AI employees.

Open a support ticket from the dashboard, email [email protected], or check the changelog, roadmap and status page. Our SLA sets the response targets.