What Is OpenToggl

OpenToggl is an open source time tracking platform that takes the current public Toggl surface as the implementation target for its own product.

It is not positioned as a vague "Toggl-like" clone. The goal is explicit:

• cover Track API v9
• cover Reports API v3
• cover Webhooks API v1
• provide the matching web interface
• support both hosted and self-hosted runtime shapes
• add import support for Toggl export data

Why OpenToggl exists

The project treats public product definitions, OpenAPI contracts, and the web surface as the source of truth.

That keeps the promise concrete:

• no hand-wavy "similar to Toggl" positioning
• no API-only first release
• no hidden split between SaaS and self-hosted capability surface
• no drift between docs, contracts, and implementation as the intended target

What is inside the repository

• product definitions under docs/
• public and OpenToggl-specific OpenAPI contracts under openapi/
• backend and frontend source under apps/
• self-hosting runbooks and smoke evidence under docs/self-hosting/ and docs/testing/evidence/

Product boundaries

The first formal scope is:

• time tracking and workspace operations through Track API v9
• reporting through Reports API v3
• webhook lifecycle and delivery through Webhooks API v1
• a web UI for the same capability surface
• Toggl export import
• instance and operator-facing hosting/runtime capabilities

OpenToggl does not claim a separate AI-native product surface. Its AI story is contract clarity and automation friendliness, not a second product hidden behind marketing language.