workset 0.2.3

Create and initialize isolated git worktree worksets.

workset

Create and initialize isolated git worktree worksets in one command.

A workset is a directory containing one or more git worktrees for related repos, each on their own branch, with submodules initialized and the Python environment ready to go. workset automates the setup so you can go from "I have a task" to a working environment without the manual back-and-forth.

Installation

uv tool install workset

Or install from source:

uv tool install --editable path/to/workset

Usage

workset --help

With date_prefix = true, worksets are created under the shared Ali workflow date layout:

<workset-root>/YYYY/MM-month/DD-ddd/<slug>/

For example:

~/Projects/worksets/2026/06-june/15-mon/my-task/

Configure dated worksets in ~/.config/workset/repos.toml:

[workset]
root = "~/Projects/worksets"
date_prefix = true
timezone = "America/Los_Angeles"

When timezone is omitted, workset uses UTC for date-prefixed paths.

Development

uv sync --extra dev
uv run ruff format --check .
uv run ruff check .
uv run mypy
uv run pytest

Publishing

Releases are published to PyPI automatically when a GitHub Release is created.