ctx

Save and restore full terminal context for developers juggling multiple repos and tasks.

What it does

One command to snapshot your entire working state — git branch, open files, env vars, running processes, tmux sessions, and notes — and restore it later.

ctx save "frontend-v2"              # Save current context
ctx save "frontend-v2" --note "WIP" # Save with a note
ctx load "frontend-v2"              # Restore it
ctx list                            # See all saved contexts

Installation

pip install ctx-switcher

Commands

What gets captured

• Git state — branch, commit, modified files, stash count
• Working directory — where you were
• Environment variables — configurable via .ctx-config.yaml
• Running processes — filtered to your user
• Tmux session — if running
• Timestamps & notes

Restoring

ctx load prints instructions to restore your state. To export env vars to your shell:

eval "$(ctx load frontend-v2 --env)"

Configuration

Create .ctx-config.yaml in your project or home directory:

env_vars:
  - NODE_ENV
  - DATABASE_URL
  - PORT
  - API_KEY

Storage

Contexts are stored at ~/.ctx-store/<hash>/<name>.json. Safe to delete anytime.

License

MIT