workstream

workstream creates named development contexts composed of Git worktrees. It owns source selection and stream lifecycle; it does not build sources or launch virtual machines.

workstream new sev-123 -s kernel -s fstests -b sev-123
workstream source -n sev-123 kernel
workstream context -n sev-123
workstream exec -n sev-123 -- make -C kernel

The versioned context document records each source path, repository, commit, branch, and dirty state. workstream context --format shell exports namespaced variables such as WORKSTREAM_SOURCE_KERNEL.

Configuration is loaded from ~/.config/workstream/config.toml, or from WORKSTREAM_CONFIG_PATH when set.

Hooks

Executable hooks may be placed in the configured hooks_dir using the names post-create, post-add, post-fork, and pre-delete. Hooks receive the JSON context document on stdin and these environment variables:

• WORKSTREAM_EVENT
• WORKSTREAM_NAME
• WORKSTREAM_DIR
• WORKSTREAM_SOURCE_<NAME>

Hook failures are warnings and do not roll back the stream operation.

Vmrun integration

Source shell-integration.sh to install the personal vm and ff helpers. They pass stream context to vmrun while vmrun targets retain all backend and VM configuration.

vm uname -a
vm shell
ff -g btrfs/quick