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.
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.
$curl -fsSL
https://headhunter45.github.io/opentasks/install.sh | bash
Designed from first principles around Git workflows, filesystem integrity, and portable distribution.
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.
Packaged as a single self-contained
.zipapp archive. Zero pip dependencies, zero
virtual environment overhead, running cleanly on Python 3.10+.
Globally unique UUIDs prevent distributed merge conflicts, while
ergonomic Git-style 6-character prefixes (e.g.
ab44e2) keep CLI usage lightning fast.
ot upgrade isolates migrations in temporary
workspaces, validates schema constraints, and executes atomic
replacement with automatic rollback on error.
ot check and ot check --fix detect
broken dependencies, cyclic hierarchies, and missing frontmatter
fields with automated repair suggestions.
Project wrappers (./oat and ./oat.bat)
allow team members to run project-locked versions without global
machine installations.
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.
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 |
ot meeting CLI subcommands (start, end, list) and meeting validation (a9baac).ot attachment CLI subcommands (add, remove, list, show) and attachment validation (ba1cd2).ot schema and ot config schema) for configuration, WorkItems, and Meetings (d2c34f, 474111).Explore the 30 formal Architecture Decision Records (ADRs) establishing Open Tasks principles.
Tasks, bugs, and meetings are stored as plain Markdown
documents with YAML frontmatter in .ot/tasks/,
branching and merging cleanly with source code.
Eliminates global tool version conflicts by packaging
standalone Python zipapps and providing transparent project
wrappers (./oat).
Guarantees project health through ot check and
automated repairs for orphaned dependencies, invalid schemas,
and corrupted hierarchies.