https://github.com/jamesread/wackytracky

Track things.
https://github.com/jamesread/wackytracky

maturity-beta

Last synced: 19 days ago
JSON representation

Track things.

• Host: GitHub
• URL: https://github.com/jamesread/wackytracky
• Owner: jamesread
• License: agpl-3.0
• Created: 2014-03-12T11:11:11.000Z (over 12 years ago)
• Default Branch: main
• Last Pushed: 2026-06-08T00:17:39.000Z (22 days ago)
• Last Synced: 2026-06-08T01:23:10.476Z (22 days ago)
• Topics: maturity-beta
• Language: Vue
• Homepage: https://jamesread.github.io/WackyTracky/
• Size: 2.19 MB
• Stars: 0
• Watchers: 1
• Forks: 2
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md
  • Security: SECURITY.md
  • Agents: AGENTS.md

Awesome Lists containing this project

README

          


  

  
WackyTracky


  Task tracking that gives power users full control over how they work.

  Web app, with desktop support that includes vim key bindings, and mobile support with offline+sync from a progressive web app (installable on your phone). The backend supports multiple database drivers, but the main focus is on the popular plain-text format [todo.txt](http://todotxt.org).

[![Maturity](https://img.shields.io/badge/maturity-Beta-orange)](#misc)

[![Discord](https://img.shields.io/discord/846737624960860180?label=Discord%20Server)](https://discord.gg/jhYWWpNJ3v)

[![AI Autonomy Level](https://img.shields.io/badge/AI%20Autonomy-Level%203%20(semi--autonomous)-blue)](#misc)

[Docs](https://jamesread.github.io/WackyTracky/) • [Docker Compose Install](#deploy-with-docker-compose) • [No Nonsense Software Principles](#no-nonsense-software-principles)



![List view](var/marketing/screenshots/list-work.png)

## Features & Benefits

* **Flexible**: Use "Getting Things Done" or similar - flexible system for tags (#bob) and contexts (@home), and priorities (A-Z).

* **Durable**: Given the app is open source and self-hosted, you can run it for years without worrying about the company going out of business or changing the product.

* **Portable**: The project recommends the todotxt backend, which stores data in plain text files that can be easily moved, edited, and backed up. You can also switch to a different backend if needed.

* **Powerful**: vim key bindings, git integration, REST/gRPC API.

## Additional Screenshots

**Task options** — Right‑click a task to open the details panel (due date, priority, notes, move to list, mark done).

![Task options](var/marketing/screenshots/task-options.png)

**TPPs** — Configure tags and contexts (labels, colors, order) in Options → TPPs.

![Task property properties](var/marketing/screenshots/tpp.png)

## Documentation

Full documentation (MkDocs) is published to **GitHub Pages**: [https://jamesread.github.io/WackyTracky/](https://jamesread.github.io/WackyTracky/). The site is built from `docs/` and deployed automatically on push to `main` (see `.github/workflows/docs.yml`).

## Deploy with Docker Compose

Container images are published to GitHub Container Registry. Quick reference to run with Docker Compose:

```yaml

# docker-compose.yml

services:

  wackytracky:

    image: ghcr.io/jamesread/wacky-tracky:latest

    ports:

      - "8080:8080"

    volumes:

      # Config: mount a file at /app/config.yaml or a directory at /config (with config.yaml inside)

      - ./config.yaml:/app/config.yaml

      # Persist todotxt data (set database.database in config to /app/data/todotxt or similar)

      - todotxt-data:/app/data

      # Persist SSH keys and other home-dir files for git push/pull (HOME=/home/wt)

      - wt-home:/home/wt

volumes:

  todotxt-data:

  wt-home:

```

Then run: `docker compose up -d`. The web UI and API are served on port 8080 by default (adjust the image’s listen port in your config if needed). Place a `config.yaml` in the same directory as your `docker-compose.yml` if you mount it; see the [documentation](https://jamesread.github.io/WackyTracky/) for config options.

## No-Nonsense Software Principles

This project follows these principles:

* **Open Source & Free Software**: following the [Open Source Definition](https://opensource.org/osd) and the [Free Software Definition](https://www.gnu.org/philosophy/free-sw.html). All code and assets are available under the [AGPL-3.0 License](LICENSE).

* **Independent**: No company owns the code or is responsible for the projects' governance.

* **Inclusive**: No "core", "pro", "premium" or "enterprise" version. The only version is the one you can download and run, and it has all the features.

* **Invisible**: No usage tracking, no user tracking, no ads, and no telemetry.

* **Internal**: No internet connection required for any functionality.

## Misc

* **AI autonomy:** This project is developed at [Level 3 (semi-autonomous)](https://blog.jread.com/posts/ai-levels-of-autonomy-in-software-engineering/): AI implements features and tests; humans define specs and direction. Specs and architecture are written by a human with 20 years of development experience. Aggressive non-AI static analysis, code-quality checks (e.g. cyclomatic complexity limits), and tests are in place to reinforce project quality.

* **Backend:** The service supports multiple database drivers (MySQL, Neo4j, YAML files, and [todo.txt](http://todotxt.org)) for different task systems. The **todotxt** driver is the one that by far receives the most focus and testing at the moment.