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

An optional .workler file declares what a 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

.workler (optional)terminal

txt

# only needed when a workspace needs local files
link node_modules
copy .env

bash

$ workler add feature-a

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

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

workler add feature-a works directly in any Git repository. It clones the project into .worktrees/feature-a, creates and checks out a new feature-a branch, and applies .workler rules when that optional file is present.