Skip to content

README.md

Latest commit

 

History

History
72 lines (50 loc) · 2.44 KB

README.md

File metadata and controls

72 lines (50 loc) · 2.44 KB

sivtr VS Code extension

Launch the sivtr AI session picker from VS Code.

Usage

Install sivtr first. Agent-memory workflows should also install the bundled sivtr-memory skill with npx skills add Ariestar/sivtr --skill sivtr-memory -g, because the extension only launches the picker; the skill is what teaches agents to query the same local memory.

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

bun install
bun run compile
bun 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.