WorklerWorkspaces that set themselves up.

A local workspace manager that clones your project into .worktrees/ and wires up the untracked files — node_modules, .env — with copy and link rules.

Getting started

What is Workler?

GitHub

🗂️

Real clones, not git worktrees

Every workspace is an ordinary local clone under .worktrees/ — its own HEAD, its own index, its own local branches. Nothing shared, nothing surprising.

🔗

Copy & link rules

A .workler file declares what every fresh workspace needs — link node_modules back to the main project, copy .env into place — applied automatically on add.

🌿

Sensible branch handling

workler add feat creates and checks out a new branch; bases, existing branches, tags, and detached checkouts are all one flag away.

🛟

Safe by default

Nothing is ever overwritten without --force, and --dry-run prints the full plan — clone, branch, every rule — before anything happens.

🔄

Multi-workspace sync

status, fetch, sync, and branch-sync operate on the main project and every workspace at once — fast-forward only, dirty workspaces never touched.

🪆

Nested workspaces

Workspaces are ordinary clones, so workler works inside them too — one workspace per feature, one nested workspace per subagent.

🧩

Typed programmatic API

Create, inspect, list, and remove workspaces from TypeScript or JavaScript with structured results, stable error codes, and per-project locking.

Quick taste

.worklerterminal

txt

# what every fresh workspace needs
link node_modules
copy .env

bash

$ workler init
$ workler add feature-a

$ workler list
main       /path/to/project
feature-a  /path/to/project/.worktrees/feature-a

$ cd "$(workler path feature-a)"

workler add feature-a clones the project into .worktrees/feature-a, creates and checks out a new feature-a branch, symlinks node_modules back to the main project, and copies .env in — a ready-to-run checkout in one command.