Getting started just got easier

Simpler API keys and automatic project setup.

Setting up Task Badger used to take more steps than it should. We've cut that down so you can go from sign-up to your first tracked task in under a minute.

One API token instead of three

Previously, integrating with Task Badger required juggling three separate values: your organization slug, project slug, and API key. That's three things to copy, three environment variables to set, and three opportunities to make a typo.

Now it's a single token. When you create a project, Task Badger generates an encoded token that includes everything. One value to copy, one environment variable to set.

export TASKBADGER_API_KEY=<your-token>

That's it. The client library handles the rest.

Automatic project setup

When you create a new account, Task Badger now sets up your first project and generates an API key automatically. No setup wizard, no extra clicks before you can write code.

The empty task list page shows you how to get started with copy-paste code examples. Your API key is already in the snippets.

Integration examples

The new landing page includes examples for the most common use cases:

Celery

Drop in the integration to automatically track your background tasks:

import taskbadger
from taskbadger.systems import CelerySystemIntegration

taskbadger.init(
    token="<your-token>",
    systems=[CelerySystemIntegration()],
)

Python SDK

Create and update tasks directly from your code:

import taskbadger

taskbadger.init()
task = taskbadger.Task.create("my first task", status="processing")
task.update(status="success", value=100)

CLI

Wrap any shell command to track its outcome:

uvx taskbadger run "nightly-backup" -- ./backup.sh

Client version requirement

The new API tokens require taskbadger>=1.7. Earlier versions don't support the new token format. If you're upgrading, update your client first:

uv add 'taskbadger>=1.7'

pip install --upgrade 'taskbadger>=1.7'

Managing your keys

You can view and copy your API token from the project settings page. The key is masked by default with a reveal button.