Skip to main content

Taskunity

A local-first, file-backed productivity web app for managing tasks. Everything lives in plain files on your disk — no database, no account, no cloud. Point Taskunity at a folder and it serves a browser UI for dashboards, a Gantt timeline, a Kanban board, a calendar, activity logs, burndown charts, and an editable task side panel.

Documentation: a full guide is in the docs/ folder and is set up to build on Read the Docs (Sphinx + Markdown).

Screenshots

PyPI renders images reliably when they use absolute GitHub URLs.

Light mode

Task List Task Board
Task List (Light) Task Board (Light)
Gantt Timeline Calendar
Gantt (Light) Calendar (Light)
Milestones Projects
Milestones (Light) Projects (Light)
Task Activity Log Settings (Theme)
Task Panel (Light) Settings Popup (Light)

Why Taskunity

  • File-backed source of truth. Each task is a single JSON file you can read, diff, and commit to git. The whole workspace is a folder you own.
  • Local-first. Runs entirely on 127.0.0.1. Your data never leaves your machine.
  • Git-aware. The UI shows branch/ahead/behind/dirty status and has a one-click commit + pull + push sync button when the workspace folder itself is a git repo.

Workspace layout

The source of truth is a workspace folder:

workspace/
  config.json           # editable workspace/app metadata
  projects/
    apollo.json         # one file per project
  tasks/
    A1B2-C3D4-E5F6-7890.json  # one file per task (native id format)
  milestones/
    M-1A2B-3C4D.json    # one file per milestone (groups tasks across projects)
  assets/
    A1B2-C3D4-E5F6-7890/  # attachments live alongside their task id
      screenshot.png

The app provides a browser UI for viewing dashboards, timelines, task boards, activity logs, burndown charts, and editing tasks through a side panel.

Install locally

From a clone of this repository:

pip install -e .

This installs the taskunity command. (A PyPI release will come later; for now install from source.)

Quick start

taskunity serve --workspace ./my-workboard

If the workspace folder does not exist yet, taskunity serve will create the empty Taskunity structure for you. You can also run it from the current directory and let Taskunity use . as the workspace.

Then open:

http://127.0.0.1:8000

init is available if you want to scaffold a folder explicitly. It creates an editable config.json, empty projects/, tasks/, milestones/, and assets/ directories, plus a README stub. It does not create starter projects or tasks; use the app to add your own once you begin.

Serve an existing workspace

taskunity serve --workspace ./path/to/workspace --host 127.0.0.1 --port 8000
Flag Default Description
--workspace . Workspace folder to serve
--host 127.0.0.1 Host interface to bind
--port 8000 Port to listen on
--reload off Enable uvicorn auto-reload (development)

Task file example

{
  "id": "A1B2-C3D4-E5F6-7890",
  "title": "CAF refinement prototype",
  "status": "working",
  "priority": "high",
  "project": "Apollo",
  "summary": "Build a prototype CAF refinement workflow.",
  "description": "Compare baseline CAF sharpness against protection-aware refinement.",
  "tags": ["caf", "signal-processing", "prototype"],
  "start_date": "2026-06-24",
  "due_date": "2026-06-30",
  "completed_date": null,
  "percent_complete": 60,
  "depends_on": ["0EBB-528F-371E-61AE"],
  "checklist": [
    {"text": "Generate baseline CAF", "done": true},
    {"text": "Export comparison plots", "done": false}
  ],
  "activity": [
    {
      "id": "a1b2c3d4",
      "event_type": "note",
      "created_at": "2026-06-26T10:30:00",
      "note_text": "Protection-aware version improved sharpness."
    },
    {
      "id": "e5f6a7b8",
      "event_type": "progress_update",
      "created_at": "2026-06-26T11:00:00",
      "progress_before": 40,
      "progress_after": 60
    }
  ]
}

depends_on stores task ids. In the UI you add dependencies with a search-as-you-type picker that finds tasks by name and shows their status, project, due date, and id — then stores the id. Dependencies are reflected on the Gantt timeline (an ↳ after <name> label plus a marker where the dependency's bar ends).

Milestones

Milestones are a separate entity from projects. A milestone can span multiple projects, holds an ordered list of tasks (which can come from any project, and a task can belong to any number of milestones), and has its own description, notes, and attachments — just like a task.

  • Open the Milestones view to see every milestone with a live rollup (task count, progress, target date).
  • Click a milestone to filter the whole board to just its tasks and show a rollup banner; the side panel opens the milestone for editing.
  • Each milestone has its own colour used on milestone cards and the rollup banner.
  • From inside a milestone you can add a task with one search-as-you-type picker and use the sticky + New task button at the bottom of the list for quick creation (auto-added to that milestone), and remove tasks.

Milestones are stored one JSON file per milestone under milestones/.

Features

  • JSON-per-task source model you can version with git
  • Dashboard summary cards (total / done / working / blocked)
  • Kanban-style board with per-project color strips
  • Gantt timeline with dependency markers
  • Calendar view
  • Milestones that group tasks across projects, with per-milestone colour, click-to-filter rollup, and their own notes/attachments/description
  • Click any task (row, card, timeline bar, calendar entry) to open an editable side panel
  • Save edits back to the JSON file; raw JSON editor escape hatch
  • Unified activity log per task: notes, images, and progress changes in chronological order
  • Task burndown chart: remaining work over time from progress_update events
  • Milestone cumulative burndown chart: aggregate remaining work across all tasks in a milestone
  • Searchable "depends on" picker that resolves names to task ids
  • Project management with custom colors, each stored in its own JSON file
  • Filtering by project, milestone, date range, and free-text search; sortable views
  • CSV / JSON export
  • Built-in git status chip and one-click sync (commit + pull + push)

Building the docs locally

pip install -e ".[docs]"
sphinx-build -b html docs docs/_build/html

Open docs/_build/html/index.html. On Read the Docs the build is driven by .readthedocs.yaml.

Development

pip install -e ".[dev]"
pytest
ruff check .

License

MIT

Metadata

Release files for taskunity 2026.42

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for taskunity 2026.42
File Size Uploaded Provenance Actions
taskunity-2026.42.tar.gz 192.8 kB Without provenance Details for taskunity-2026.42.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for taskunity 2026.42
File Interpreter ABI Platform Actions
taskunity-2026.42-py3-none-any.whl Python 3 none any Details for taskunity-2026.42-py3-none-any.whl

Total release size: 391.2 kB

Release files / taskunity-2026.42.tar.gz

Download URL taskunity-2026.42.tar.gz
Size 192.8 kB
Tags Source
SHA-256 checksum
How to use checksums
fdbb005e09c656957994db58c5ff45ad578cf573242662425e56da20002412dc
BLAKE2b-256 checksum
How to use checksums
39b3c574c33391115a21d1218770ab8b98139c779e4aebd98a75f7457608c658
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.14

Release files / taskunity-2026.42-py3-none-any.whl

Download URL taskunity-2026.42-py3-none-any.whl
Size 198.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
a1bfa64205351c91c43ca93c15f558d00c8545cac83e43dc3edb76e5f849cede
BLAKE2b-256 checksum
How to use checksums
40fcf2529e9fed6c9041730ed52c214985516a40b31e1910d309e258ae789e35
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.14

Security for taskunity 2026.42

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

2026.42 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page