Aweshelf for VS Code
Browse, search, edit, and resume aweshelf AI coding session bookmarks from VS Code.
Installation
From VS Code Marketplace
- Open VS Code
- Go to Extensions (Ctrl+Shift+X / Cmd+Shift+X)
- Search for Aweshelf
- Click Install
From VSIX file
- Download the
.vsix file from GitHub Releases
- In VS Code: Ctrl+Shift+P → Extensions: Install from VSIX...
- 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
- 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
- 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
| Setting |
Default |
Description |
aweshelf.commandPath |
aweshelf |
Path to the aweshelf executable |
aweshelf.configPath |
"" |
Optional AWESHELF_CONFIG path. Leave empty to use ~/.config/aweshelf/bookmarks.json |
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.
| |
