sivtr VS Code extension
Launch the sivtr AI session picker from VS Code.
Usage
Install sivtr first:
cargo install sivtr
If sivtr is missing, the extension will offer to open a terminal and run that
install command.
Run Sivtr: Pick AI Session from the command palette, or press Alt+Y.
The extension opens a VS Code terminal in the current workspace and runs the
context-aware AI session picker:
sivtr hotkey-pick-agent --cwd . --provider all
Before launching, the extension resolves the workspace path and quotes the
command line for the active shell, so paths with spaces or quotes work across
PowerShell, cmd.exe, fish, and POSIX shells.
If the terminal was opened from a live codex resume session, sivtr prefers
that exact session id first. Otherwise it falls back to the newest non-empty
session whose cwd matches the workspace.
On Linux, this VS Code keybinding is the recommended default shortcut. sivtr
does not currently provide a desktop-wide global hotkey on Linux outside VS
Code because global shortcut registration and terminal launching are not
portable across Wayland, X11, and terminal-only environments.
On macOS, the same VS Code shortcut is also the recommended default shortcut.
If you want a Terminal-based launcher outside VS Code, run
sivtr init macos-shortcut on the Mac host.
Quick one-line fallback outside VS Code:
sivtr init macos-shortcut && ~/.local/bin/sivtr-pick-codex
Settings
| Setting |
Default |
Purpose |
sivtr.command |
sivtr |
Command used to launch sivtr |
sivtr.args |
["hotkey-pick-agent", "--cwd", ".", "--provider", "all"] |
Arguments passed to sivtr |
sivtr.reuseTerminal |
true |
Reuse the existing sivtr terminal |
sivtr.closeTerminalOnSuccess |
true |
Close the sivtr terminal when the picker exits successfully |
sivtr.terminalName |
sivtr |
Terminal name |
To use Ctrl+Y, override the keybinding in VS Code Keyboard Shortcuts.
Development
pnpm install
pnpm run compile
pnpm run package
Open this folder in VS Code and press F5 to launch an Extension Development Host.
License
Apache License 2.0. See the repository LICENSE.