auto-pin
by stv1024Automatically pin new Paseo workspaces, with defaults and rules for individual projects.
Gallery
- Requires Paseo >=0.9.1 <0.10.0 and Node.js/npm on the daemon host.
- Uses Paseo's internal daemon client API for workspace pinning.
- Rules apply to newly created workspaces only; existing pins and restored workspaces stay unchanged.
Install
npmjs · Paseo 0.9+
paseo plugin add npm:paseo-auto-pin@0.4.0GitHub · Paseo 0.8 fallback
paseo plugin add stv1024/paseo-auto-pin --ref 2685698055b7cb6476392f3b0661a5c56ac49415Git security status and fallback installation are pinned to commit 2685698055b7.
From the plugin's README
Requires Paseo 0.9.1–0.9.x and Node.js/npm on the machine running the Paseo daemon.
paseo plugin install npm:paseo-auto-pin@0.4.0
Or install from GitHub:
paseo plugin install https://github.com/stv1024/paseo-auto-pin
Open Auto-Pin in the sidebar to adjust your settings. It starts with auto-pin on for all new workspaces.
README
Auto-Pin for Paseo
Automatically pin new Paseo workspaces, with exceptions for individual projects.
Keep everyday work near the top of your sidebar and leave experiments unpinned. Auto-Pin runs in the background, even when its panel is closed.
Create a workspace. Auto-Pin moves it into Pinned automatically. Watch the original video.
Install
Requires Paseo 0.9.1–0.9.x and Node.js/npm on the machine running the Paseo daemon.
paseo plugin install npm:paseo-auto-pin@0.4.0
Or install from GitHub:
paseo plugin install https://github.com/stv1024/paseo-auto-pin
Open Auto-Pin in the sidebar to adjust your settings. It starts with auto-pin on for all new workspaces.
Choose what gets pinned
The Pin new workspaces by default switch sets the behavior for projects without an override. Each project has three choices:
| Rule | What happens when you create a workspace |
|---|---|
| Follow default | Uses the current default switch. |
| Always | Pins it, even when the default is off. |
| Never | Leaves it unpinned, even when the default is on. |
For example, set your main project to Always, experiments to Never, and leave everything else on Follow default.
Projects appear automatically from Paseo. You can search by name or folder path. Rules apply to new workspaces belonging to that project, including worktrees.
A few things to know
- Changes save automatically and are shared by clients connected to the same daemon.
- Rules only affect workspaces created afterward. Existing pins stay as they are.
- Restoring an archived workspace does not pin it again.
- Auto-Pin never removes a pin. You can still pin or unpin workspaces yourself.
- Always and Never override the default switch. To pause the entire plugin, disable it in Paseo's plugin settings.
In the Command Center, use Auto-Pin: Toggle Default for a quick change, or Auto-Pin: Open Panel to manage project rules.
Update
For an installation from npm or Git:
paseo plugin update auto-pin --check
paseo plugin update auto-pin
Updating from 0.3 keeps your existing on/off setting. Every project starts on Follow default until you choose otherwise.
Auto-Pin 0.4.x supports Paseo 0.9.1–0.9.x. For Paseo 0.8, use Auto-Pin 0.2.0; for Paseo 0.7, use 0.1.0.
Need a hand?
If a new workspace is not pinned, check its project rule and the default switch. If you just changed a setting on another device, press Refresh in the panel.
For errors or unexpected behavior, open an issue.
Include your Paseo and Auto-Pin versions, the rule you selected, and what happened.
Logs are available with paseo plugin logs auto-pin; remove private paths before
sharing them.
Have a workflow this does not cover? Describe it in an issue. A concrete example helps decide what to build next.
Share your workflow in the Paseo community discussion.
What's changed · Development · Community post and demo guide
License
Scanned 25 Sep 2026, 12:19 UTC from stv1024/paseo-auto-pin.