Add optional project scratchpad system#5109
Closed
Bucurenciu-Cristian wants to merge 10 commits into
Closed
Conversation
State management and hyprctl dispatch for project-specific special workspaces. Supports toggle, send, quick-switch, and state queries.
Switches project context: updates state file, switches tmux session (creates if missing), logs switch for daily tracking.
Interactive project management via walker --dmenu: create, delete, shelve/unshelve with accountability prompts, focus mode, server activity detection, and daily switch budget.
Opens user's default terminal attached to current project's tmux session. Creates session if missing.
JSON output for waybar custom module showing active project count, daily switch budget usage, and recent activity log.
Installer for project scratchpad system. Checks deps (tmux, jq), bootstraps projects.conf, creates state directory, and injects keybindings into bindings.conf with BEGIN/END markers.
Clean uninstaller with confirmation prompt. Removes keybinding block (between BEGIN/END markers) and state files. Never deletes projects.conf (user data).
- Use grep -c instead of grep | wc -l (SC2126) - Prefix unused variable with underscore (SC2034) - Remove unused PROJECT variable in terminal script (SC2034)
Shows current project name, position index, and window count in waybar. Hidden when no project switch has occurred.
More ergonomic and consistent with the Super+Shift pattern for project-related keybindings.
Contributor
There was a problem hiding this comment.
Copilot wasn't able to review any files in this pull request.
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
Member
|
Fascinating system, but it's a bit too much for default Omarchy. Might it make sense as an AUR package that folks can install? Thanks for exploring it! |
Author
|
Okay. Thanks for the feedback. I'll do this next week. It would be very nice to showcase it on the omarchy manual, after it's public and live, if you want this for sure. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
The problem
When you work on multiple projects, switching context is painful. You lose track of which windows belong to which project, your terminal is in the wrong directory, and your tmux session is attached to yesterday's work. Alt-tabbing through 20 windows to find the right ones kills flow.
The solution
Project scratchpads give each project its own special workspace — a dedicated container for its windows, linked to a tmux session and project directory. Switch projects and everything follows: your workspace, your terminal, your context.
I've been using this system daily for the past 3 months across 7 active projects. This PR is the cleaned-up, omarchy-convention-compliant version of what's been running on my machine since January.
Install:
omarchy-install-project-scratchpadsUninstall:
omarchy-uninstall-project-scratchpads(keeps your project list)What you get
special:project:<name>, toggle it like a scratchpadCtrl+Alt+1-9jumps to project N instantly▶indicator next to projects with running dev servers (bun, node, python, etc.)Keybindings (added by installer)
Super+;Super+Alt+;Super+Shift+PCtrl+Alt+1-9Ctrl+Alt+Shift+1-9Dependencies
Files added
8 self-contained scripts, 1,051 lines. No existing files modified. All follow omarchy conventions (
omarchy-prefix,#!/bin/bash, 2-space indent, no shared libs).Test plan
Open to feedback — happy to adjust keybindings, rename scripts, refactor approaches, or split this into smaller PRs if that's easier to review. If anyone sees opportunities to make this faster or more idiomatic, I'm all ears.