terminal-workspace
Terminal workspace management with Zellij. Use when user mentions terminal sessions, workspaces, Zellij, terminal layouts, or persistent terminal environments. Covers session management, layout saving, and the zp quick-access alias.
When & Why to Use This Skill
This Claude skill facilitates advanced terminal workspace management through Zellij, enabling developers to maintain persistent sessions and custom layouts. It optimizes productivity by allowing users to quickly switch between project environments, save complex terminal configurations, and ensure that working states remain intact across sessions, making it an essential tool for CLI-centric workflows.
Use Cases
- Project-Based Session Management: Automatically create or attach to a dedicated terminal session based on the current project directory using the 'zp' alias for instant context switching.
- Complex Layout Preservation: Save and restore intricate terminal window arrangements, including multiple panes and specific tool placements, using Zellij's layout dumping feature to avoid manual setup.
- Persistent Development Environments: Maintain long-running terminal states and processes that survive SSH disconnections or local terminal restarts, ensuring no progress is lost.
- Workflow Standardization: Standardize workspace setups across different machines or team members by sharing Zellij layout files (.kdl) for consistent development environments.
| name | terminal-workspace |
|---|---|
| description | Terminal workspace management with Zellij. Use when user mentions terminal sessions, workspaces, Zellij, terminal layouts, or persistent terminal environments. Covers session management, layout saving, and the zp quick-access alias. |
Terminal Workspace Management
Persistent terminal workspaces per project using Zellij.
Core Concepts
- Sessions: Working state (ephemeral, survives disconnects)
- Layouts: Workspace recipes (permanent, recreatable)
- Real persistence: Lives in applications (vim sessions, git)
Quick Access
# In ~/.zshrc or ~/.bashrc
alias zp='zellij attach $(basename "$PWD") || zellij -s $(basename "$PWD")'
Run zp in any project directory to create/attach its workspace.
Save Important Layouts
# If you have a complex setup worth preserving
zellij action dump-layout > ~/.config/zellij/layouts/project-name.kdl
Philosophy
Zellij sessions for convenience, not critical state. If it matters, it's in a file.