Getting Started
Install the CLI and start managing work with Taskulus in minutes.
Download the tskr binary
Grab the prebuilt Rust CLI for your platform.
Download the latest release from GitHub Releases. Replace the version and target with the artifact that matches your platform.
curl -L -o tskr.tar.gz https://github.com/AnthusAI/Taskulus/releases/download/v0.1.0/tskr-x86_64-unknown-linux-gnu.tar.gz tar -xzf tskr.tar.gz chmod +x tskr ./tskr --help
The binary name is tskr.
Install with pip
Use the Python CLI for fast iteration and scripting.
Install Taskulus from PyPI and use the tsk command.
python -m pip install taskulus tsk --help
Install with cargo
Rust installation is coming soon.
We will publish tskr to crates.io once the registry listing is ready.
cargo install tskr
Build from source
Clone the repo and run directly.
git clone https://github.com/AnthusAI/Taskulus.git cd Taskulus
cd rust cargo build --release ./target/release/tskr --help
cd python python -m pip install -e . tsk --help
Initialize Your Repository
Create the Taskulus structure in an existing git repo.
Run tsk init once in the repository root. It creates the project/ directory and the repo-level.taskulus.yml file.
cd your-repo git init tsk init
Keep Configuration Updated
Evolve workflows and defaults without re-running init.
Edit project/config.yaml to change hierarchy, workflows, priorities, and defaults. Use.taskulus.override.yml for local-only settings like assignee or time zone.
tsk list tsk ready
Beads Compatibility During Transition
Keep JSONL data while moving to Taskulus.
If your repo still stores issues in .beads/issues.jsonl, enable compatibility in both config files.
.taskulus.yml beads_compatibility: true project/config.yaml beads_compatibility: true