Context Workspaces

A workspace toolkit to build focused, clutter-free zones for every task

Context Workspaces extends Obsidian's built-in Workspace functionality to provide a fast and intuitive context switching experience similar to Arc browser.

Quick Demo

https://github.com/user-attachments/assets/3e9b9ffa-e861-431d-88f4-cbb306b79c4f

Key Features

Auto Save/Restore Mode

• Live Mode: Automatically saves and restores current state when switching spaces
• Snapshot Mode: Default Workspace behavior, manual save/load

Sidebar UI

• Shows your spaces as icons in a custom sidebar
• Double-click an icon to switch spaces
• Right-click for context menu (edit, toggle auto-save, delete)
• Previous/Next buttons for quick navigation

Space-Specific Theme Settings

• Unique theme and mode settings for each space
• Automatically changes theme when switching spaces
• Light/Dark/System mode support
• Choose from all available Obsidian themes

Drag & Drop Interface

• Space reordering: Drag and drop to reorder spaces

Obsidian Workspace API Integration

• Bidirectional Sync: Automatic synchronization with Obsidian's built-in Workspace API
• Import Existing Workspaces: Automatically imports existing Obsidian workspaces as spaces
• Auto-switch on Workspace Load: Automatically switch to corresponding Context Space when using Obsidian's loadWorkspace API

Installation

Manual Installation

1. Download the latest release from the releases page
2. Copy main.js, manifest.json, styles.css files to your Obsidian vault's .obsidian/plugins/context-workspaces/ folder
3. Enable Context Workspaces in Obsidian under Community plugins

BRAT Installation (Beta Testing)

1. Install the BRAT plugin in Obsidian
2. Go to Settings > Community plugins > Beta plugin list
3. Add this repository: jinmugo/obsidian-context-workspaces
4. Enable Context Workspaces in the Community plugins list

Development Installation

cd /path/to/your/vault/.obsidian/plugins/
git clone https://github.com/jinmugo/obsidian-context-workspaces.git context-workspaces
cd context-workspaces
pnpm install
pnpm build

Usage

Basic Usage

1. Switch Spaces: Click or double-click space icons in the sidebar
2. Create New Space: Run "Create New Space" from command palette
3. Keyboard Shortcuts: Set shortcuts for "Switch to Next Space", "Switch to Previous Space" commands

Space Mode Settings

• Toggle auto-save mode for each space in Settings > Context Workspaces
• Auto-save ON: Automatically saves and restores current state when switching spaces
• Auto-save OFF: Default Workspace behavior (manual save/load)

Theme Settings

• Set theme and mode for each space in Space Edit
• Theme: Choose from all available Obsidian themes
• Mode: Choose Light, Dark, or System mode
• Theme and mode are automatically applied when switching spaces

Commands

• Switch to Next Space: Switch to next space in the list
• Switch to Previous Space: Switch to previous space in the list
• Create New Space: Create new workspace
• Manage Spaces: Manage space list and settings
• Edit Current Space: Edit settings for current active space

Recommended Keyboard Shortcuts

Switch to Next Space: Ctrl + Tab (or Cmd + Option + →)
Switch to Previous Space: Ctrl + Shift + Tab (or Cmd + Option + ←)
Create New Space: Ctrl + Shift + N

Contributing

Contributions are welcome! You can participate in the following ways:

• Bug Reports: Report issues on GitHub
• Feature Requests: Suggest new features
• Code Contributions: Submit pull requests
• Documentation: Help improve documentation