中文

OpenTickly

OpenTickly is a free, private-first, AI-friendly alternative to Toggl.

Toggl is a great product, but it's expensive and your data doesn't really belong to you. On top of that, the 30 requests/hour API limit is painful — an AI agent can burn through an hour's quota in a single minute.

OpenTickly aims to stay aligned with Toggl, so you can move your data in and out between the two without any loss. Keep every workflow and habit you already have. Nothing changes — it just gets better, cheaper, and more private.

AI Integration

OpenTickly works directly with toggl-cli, so AI can help you record, manage, and review your time. Apply the Lyubishchev time management method to find the black holes in your day.

Read the full docs here.

Self-Hosting

Deploy via Docker Compose on your own home server — NAS, CasaOS/ZimaOS, Synology, TrueNAS, and more.

Read the self-hosting docs

Unraid Community Apps

This repository includes Community Apps metadata for an Unraid Docker template:

• Repository profile: ca_profile.xml
• Docker template: templates/opentickly.xml
• App icon: the canonical product icon apps/website/public/favicon.svg (referenced by raw URL; no separate copy)

Before submitting or updating the app in Community Apps:

1. Keep TemplateURL pointed at the raw GitHub URL for templates/opentickly.xml.

2. Keep ca_profile.xml in the repository root with a non-empty Profile.

3. Confirm the template image matches the published Docker image.

4. Run XML validation locally:

   xmllint --noout ca_profile.xml templates/opentickly.xml apps/website/public/favicon.svg

5. Run Validate and Scan in the Unraid Community Apps submit flow.

The Unraid template expects PostgreSQL and Redis to be reachable from the OpenTickly container. Create those services first, then set DATABASE_URL and REDIS_URL in the template.

Mobile PWA Support

The web UI is an installable Progressive Web App (PWA). On mobile (iOS and Android) you can add it to your home screen and use it like a native app.

Roadmap

• Full API compatibility with Track v9 and Reports v3
• Full parity with Toggl Track web
• Mobile PWA with offline support

Get Started

• Repository: https://github.com/CorrectRoadH/OpenTickly
• Self-hosting docs: ./docs/self-hosting/docker-compose.md
• CLI: https://github.com/CorrectRoadH/toggl-cli

Acknowledgments

OpenTickly's design is inspired by Toggl, and we aim to stay compatible with their product surface so you can keep your existing workflow.

We also thank Linux Do for their support and feedback during the project's early development.