fastws

Fast workspace tools for multi-repo management.

Install

pip install fastws-cli

Setup

Create a repos.txt file listing your repos (one per line):

AnswerDotAI/fastcore
AnswerDotAI/fastgit
AnswerDotAI/fastship
AnswerDotAI/fastws

Commands

ws-clone

Clone all repos from your repos file:

ws-clone
ws-clone --repos-file myrepos.txt
ws-clone --workers 8

ws-pull

Pull updates for all repos (parallel):

ws-pull

ws-status

Show uncommitted changes and unpushed commits:

ws-status
ws-status --branches

ws-branches

Check if all repos are on the expected branch:

ws-branches
ws-branches --expected develop

ws-sync

Sync the workspace metadata, pull local repos, install updates, and refresh Pyright editable paths. By default it uses the active venv parent as the workspace root, so you do not need to cd first: It respects tool.uv.workspace.members and exclude when scanning local projects.

ws-sync
ws-sync --workspace ~/aai-ws

ws-add

Add a repo to repos.txt, then run ws-sync:

ws-add AnswerDotAI/fastws
ws-add answerdotai/fastws