# 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.

- Skill: `majiayu000/terminal-workspace` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add majiayu000/terminal-workspace`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/terminal-workspace/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/terminal-workspace

---


# 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

```bash
# 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

```bash
# 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.