Repository-Native & Self-Hosted

Task management built directly into your Git repository.

Zero database backends. Zero SaaS vendor lock-in. Just clean Markdown documents with YAML frontmatter, Git-style short identifiers, cryptographic validation, and standalone Python zipapps.

One-line installer
$curl -fsSL https://headhunter45.github.io/opentasks/install.sh | bash

Engineered for Developer Velocity

Designed from first principles around Git workflows, filesystem integrity, and portable distribution.

📁

Repository-Native Storage

Every task, bug, epic, and meeting is an individual Markdown file in .ot/tasks/. All changes branch, merge, and diff directly with your source code.

📦

Standalone ZipApp Binary

Packaged as a single self-contained .zipapp archive. Zero pip dependencies, zero virtual environment overhead, running cleanly on Python 3.10+.

🔑

UUIDs & Git-Style Short IDs

Globally unique UUIDs prevent distributed merge conflicts, while ergonomic Git-style 6-character prefixes (e.g. ab44e2) keep CLI usage lightning fast.

🛡️

Transactional Upgrades

ot upgrade isolates migrations in temporary workspaces, validates schema constraints, and executes atomic replacement with automatic rollback on error.

🩺

First-Class Validation

ot check and ot check --fix detect broken dependencies, cyclic hierarchies, and missing frontmatter fields with automated repair suggestions.

⚡

Optional Wrapper Scripts

Project wrappers (./oat and ./oat.bat) allow team members to run project-locked versions without global machine installations.

CLI Workflow at a Glance

Inspect common operations from initialization to self-hosted release builds.

# In your repository root, initialize Open Tasks
$ ot init
Initialized Open Tasks project in /Users/dev/my-project/.ot
Created configuration in .ot/config.json
Installed default templates in .ot/templates/
Installed project binary in .ot/bin/0.4.0/ot.zipapp
Created wrapper scripts: oat, oat.bat

# Verify project version
$ ./oat version
Open Tasks v0.4.0
Project root:       /Users/dev/my-project
Configured version: 0.4.0
Installed version:  0.4.0
# Create a new feature task with positional title or flags
$ ./oat task create "User Authentication Flow" --type feature --size medium
Created work item: 4a9f2b (User Authentication Flow)
Location: .ot/tasks/UserAuthenticationFlow/index.md

# Query by multiple columns, comma-separated values, prefixes, or positional IDs
$ ./oat task list -s triage,planned -t feature,bug
ID       Title                        Type         Status
-------- ---------------------------- ------------ ------------
4a9f2b   User Authentication Flow     Feature      Planned

# Update frontmatter fields & add comments via CLI
$ ./oat task update 4a9f2b --status in_progress --size large --tag auth,security
$ ./oat task comment 4a9f2b "Integrating OAuth2 token validation."
# Perform zero-warning diagnostic check across all tasks & frontmatter
$ ./oat check
Project check passed: No errors or warnings detected.

# Machine-readable JSON output for CI/CD gates
$ ./oat check --json
[]
# Perform non-destructive transactional upgrade with rollback protection
$ ot upgrade --version 0.2.0
Validating target version 0.2.0...
Staging upgrade in isolated temporary workspace...
Applying schema validation checks...
Successfully upgraded project from 0.1.0 to 0.2.0.

Official Release Downloads

Standalone, zero-dependency executable zipapps built from verified source releases.

Artifact Type Verification Action
ot.zipapp
Latest stable executable launcher
ZipApp Binary SHA-256 Verified in SHA256SUMS Download
ot-0.4.0.zipapp
Version 0.4.0 standalone release
ZipApp Binary SHA-256: 90df0b96090f... Download
SHA256SUMS
Cryptographic release integrity verification
Checksum File Official Release Hashes View
ot-0.4.0-manifest.json
Release metadata & schema manifest
JSON Manifest Schema Version 1 View
Release Notes

Changes in v0.4.0

  • Implement ot meeting CLI subcommands (start, end, list) and meeting validation (a9baac).
  • Implement ot attachment CLI subcommands (add, remove, list, show) and attachment validation (ba1cd2).
  • Implement JSON Schema export (ot schema and ot config schema) for configuration, WorkItems, and Meetings (d2c34f, 474111).

Architecture Decision Records & Design

Explore the 30 formal Architecture Decision Records (ADRs) establishing Open Tasks principles.

ADR-0001 • Core Storage

Repository-Native Storage

Tasks, bugs, and meetings are stored as plain Markdown documents with YAML frontmatter in .ot/tasks/, branching and merging cleanly with source code.

ADR-0001 to ADR-0008 Read ADR →
ADR-0009 • Packaging

Project Wrappers & Standalone Binaries

Eliminates global tool version conflicts by packaging standalone Python zipapps and providing transparent project wrappers (./oat).

ADR-0009 to ADR-0015 Read ADR →
ADR-0023 • Validation

First-Class Validation & Repair

Guarantees project health through ot check and automated repairs for orphaned dependencies, invalid schemas, and corrupted hierarchies.

ADR-0016 to ADR-0030 Read ADR →