aweshelf-ext

Browse, search, edit, and resume aweshelf AI coding session bookmarks from VS Code.

Installation

From VS Code Marketplace

1. Open VS Code
2. Go to Extensions (Ctrl+Shift+X / Cmd+Shift+X)
3. Search for Aweshelf
4. Click Install

From VSIX file

1. Download the .vsix file from GitHub Releases
2. In VS Code: Ctrl+Shift+P → Extensions: Install from VSIX...
3. Select the downloaded .vsix file

Or via command line:

code --install-extension aweshelf-0.0.1.vsix

Requirements

• Python aweshelf CLI installed and available on PATH, or configure aweshelf.commandPath.
• Optional: aweswitch for Claude profile-based resume.

Features

Sidebar

• Bookmark tree view grouped by category
• Search bookmarks by title, category, session ID, project, or profile
• Sort by ID or recent
• Filter by provider or category
• Auto-refresh on bookmark store changes

Bookmark Actions (right-click menu)

• Show bookmark details as Markdown
• Edit title, category, and aweswitch profile
• Resume normally, resume raw, or resume with a selected profile
• Copy session ID or resume command
• Open the bookmarked project path
• Remove bookmarks with confirmation

Session Management

• Bookmark a discovered session through QuickPick

Settings

Development

npm install
npm run compile

Open this folder in VS Code and run Run Aweshelf Extension from the Run and Debug view.

Package

npm run package

This creates a .vsix file for distribution.