Skip to content
Sessions is a tool that allows you to save and access your different digital workspaces.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


Sessions is a tool that allows you to save and access your different digital workspaces. It saves the collection of apps, documents, and websites on your computer and allows you to reopen that collection anytime you want. This allows you to:

  • Have less computational overhead by closing unnecessary processes
  • Reduce distractions by closing (but not forgetting) the digital remnants of other tasks
  • Overall have a more organized headspace for your different computational needs

How it works

Sessions saves all open apps and their relevant data (files, websites, window sizes, etc.) in a singular JSON file as a "session". It can update this file as you close and open other processes, and open other sessions entirely (via their files).

How to install

The current Sessions prototype runs through AppleScript and Automator (for the time being). This is mainly because of the new Mojave sandbox problems, as there aren't many easy ways to manipulate other apps from within an app.

1. Download the Apple Scripts

There are six scripts you will find in this repo:
  • Create_Session Script
  • Save_Session Script
  • Open_Session Script
  • Close_Session Script
  • Sessions_App Script
  • Initializater Script

Open the Initializer Script first, and press run. This will create all the necessary folders and files needed to manage your sessions.

2. Download helper programs

This application relies on helper programs for several small things. Please download them!

3. Create Quick Actions

4. Allowing Permissions

When you first run the scripts using your Quick Actions / Automator, your computer may ask you for accessibility and UI permissions. Make sure to add those permissions in.

5. Access Your Sessions

Your sessions can be found at `user/Library/Sessions/Sessions`. You can duplicate, modify, and delete them there. In case you lose something, backups can be found at `user/Library/Sessions/Sessions_Backups`.

How to use

1. Creating a Session

2. Opening a Session

3. Best Practices

Suggested Sessions

You can find some suggested usages for sessions in the Examples folder.

Adding new apps

There has to be some level of AppleScript support for new apps. I also have to add the file icon to the dictionary, so it knows which .icns file to pull data from. It's a whole thing that's a problem!!

Future changes

  • A functional Menu Bar App
  • Whitelisted Apps
  • Additional third-party app compatibility
  • Support for multiple desktop spaces
  • Options for timing
  • UI Update
  • Shift to Xcode App completely
  • Add suggested Sessions
  • Open to suggestions!
You can’t perform that action at this time.