Context Recall

Never lose your place again. Context Recall helps you manage multiple tasks by capturing and restoring complete workspace snapshots—including open files, cursor positions, and Git branches.

Features

📋 Task Profiles

Create profiles that snapshot your entire workspace context:

• Open files and their cursor positions
• Active editor state
• Git branch associations
• Custom notes and descriptions

🔄 Seamless Task Switching

Switch between tasks instantly with full context restoration:

• Automatically open the right files
• Restore cursor positions exactly where you left off
• Checkout the associated Git branch
• Apply Git stashes automatically

🌿 Smart Git Integration

Context Recall integrates deeply with your Git workflow:

• Automatic profile creation when creating new branches
• Auto-switch to profiles when changing branches via command line
• Git stash support to preserve uncommitted changes when switching
• Automatic cleanup when branches are deleted

⚙️ Flexible Automation

Choose how Context Recall behaves with multiple configuration modes:

Task Creation:

• Manual - Create profiles when you want
• Prompt on new branch - Ask when you create a branch
• Automatic on new branch - Always create profiles for new branches

Profile Switching:

• Manual - Switch profiles manually
• Prompt when task exists - Ask when switching to a branch with a profile
• Automatic when task exists - Auto-switch to matching profiles

Task Deletion:

• Manual - Never auto-delete
• Automatic on branch deletion - Clean up when branches are deleted

Getting Started

1. Create a Task Profile: Click the + icon in the Context Recall sidebar or use the command palette (Ctrl+Shift+P → "Context Recall: Create New Task Profile")

2. Switch Between Tasks: Click on any profile in the sidebar to instantly switch your workspace context

3. Configure Automation: Click the gear icon in the sidebar to configure how Context Recall works with your Git workflow

Commands

• Context Recall: Create New Task Profile - Create a new task profile from current state
• Context Recall: Switch Task Profile - Switch to a different task profile
• Context Recall: Edit Task Profile - Edit profile details and settings
• Context Recall: Delete Task Profile - Delete a task profile
• Context Recall: Open Settings - Configure Context Recall behavior

Extension Settings

This extension contributes the following settings:

Automation Settings

• contextRecall.taskCreationMode - How new task profiles are created (Manual, Prompt on new branch, Automatic on new branch)
• contextRecall.taskDeletionMode - When to delete task profiles for deleted branches (Manual, Automatic on branch deletion)
• contextRecall.profileSwitchMode - How to handle switching to matching task profiles when changing branches (Manual, Prompt when task exists, Automatic when task exists)
• contextRecall.promptOnBranchSwitch - Prompt to delete profile when switching away from a branch

Profile Defaults

These settings control the default behavior for new task profiles:

• contextRecall.defaults.autoUpdate - Automatically save changes when files are modified (default: true)
• contextRecall.defaults.createStashOnSwitch - Create git stash when switching away from this profile (default: true)
• contextRecall.defaults.autoCheckoutBranch - Automatically checkout the associated git branch when switching to this profile (default: true)
• contextRecall.defaults.closeEditorsOnSwitch - Close all open editors when switching away from this profile (default: false)

Use Cases

Multi-Task Development

Working on a bug fix while also developing a new feature? Create separate profiles for each task and switch between them without losing context.

Code Reviews

Create a profile for each pull request you're reviewing. Open all the relevant files, add notes, and return to exactly where you left off.

Learning New Codebases

Create profiles for different areas of the codebase you're exploring. Keep track of your progress and notes for each area.

Feature Branch Workflow

Let Context Recall automatically create and switch profiles as you work with Git branches. Your workspace always matches your current branch.

Requirements

• VS Code 1.95.0 or higher
• Git (for Git integration features)

Known Issues

Please report any issues on the GitHub repository.

Release Notes

0.0.1

Initial release of Context Recall

Features:

• Task profile creation and management
• Open file and cursor position capture
• Git branch association and auto-checkout
• Git stash creation and restoration
• Automatic profile creation for new branches
• Automatic profile switching on branch change
• Automatic profile deletion on branch deletion
• Configurable automation modes
• Tree view for profile management
• Status bar integration

Feedback & Support

If you find Context Recall helpful, please consider:

• ⭐ Rating it on the marketplace
• 🐛 Reporting issues or requesting features
• 💬 Sharing your feedback

Happy coding! 🚀