Workspace Script

A custom workspace management script that automates tmux session creation and management for organized project development.

Overview #

The workspace script provides automated tmux session management, making it easy to:

• Create organized session groups
• Quickly switch between projects
• Maintain consistent development environments
• Sync workspace configuration across machines

Location #

~/git/workspaces/workspaces.py

Features #

• Git repository discovery - Automatically find repos in workspace directories
• Session groups - Organize related projects
• Quick attach - Fast switching between workspaces
• Configuration sync - Keep workspace definitions in version control

Usage #

Basic Commands #

# Attach to workspace (creates if needed)
~/git/workspaces/workspaces.py -W git attach

# Create new workspace
~/git/workspaces/workspaces.py -W git create

# Add current repo to workspace
~/git/workspaces/workspaces.py -W git add

From tmux #

The script integrates with tmux keybindings:

How It Works #

1. Discovers repositories - Scans configured directories for git repos
2. Creates sessions - Generates tmux sessions with standardized layouts
3. Manages windows - Each repo gets its own window or layout
4. Syncs config - Stores workspace definitions in git-tracked files

Configuration #

Workspaces are defined in:

~/.config/workspaces/config.toml

Example:

[workspaces.git]
path = "~/git"
auto_discover = true
layout = "main-vertical"

[workspaces.work]
path = "~/work"
auto_discover = false
repos = ["project1", "project2"]

Integration with tmux #

The script is called from tmux keybindings in ~/.tmux.conf:

bind -n M-Space display-popup -T 'attach to workspace' -E -d '~/git' "~/git/workspaces/workspaces.py -W git attach"

This creates popup windows for workspace management without leaving your current context.

See Also #

GitHub - nvim-telescope/telescope-project.nvim

Contribute to nvim-telescope/telescope-project.nvim development by creating an account on GitHub.

GitHub · github.com