Skip to content

Add zoxide extension#265

Open
oxysoft wants to merge 1 commit intovicinaehq:mainfrom
oxysoft:feat/zoxide-extension
Open

Add zoxide extension#265
oxysoft wants to merge 1 commit intovicinaehq:mainfrom
oxysoft:feat/zoxide-extension

Conversation

@oxysoft
Copy link
Copy Markdown

@oxysoft oxysoft commented May 7, 2026

Summary

  • Native zoxide integration for fuzzy directory jumping on Linux
  • Uses Vicinae's built-in fuzzy filter via List.Item.keywords — each directory entry carries the full path, every segment, and adjacent segment pairs, so typing any fragment of any parent directory matches naturally
  • Configurable program actions: terminal (autodetected), editor, file manager, plus 5 user-defined program slots with ctrl+1..5 shortcuts
  • Add/remove directories from zoxide's database inline

Why not port the Raycast extension?

The upstream raycast-zoxide pipes results through fzf --exact and relies on macOS-specific features (Finder, Spotlight, AppleScript). The fzf layer fights Vicinae's native fuzzy — title-only matching means parent-directory fragments never hit. This is a clean rewrite that drops fzf entirely and uses keywords for full-path fuzzy matching.

Requirements

  • zoxide installed and on PATH
  • A terminal emulator (autodetected: kitty, alacritty, wezterm, foot, ghostty, gnome-terminal, konsole, xterm)

Test plan

  • npm install && npx vici lint passes
  • npx vici build installs to ~/.local/share/vicinae/extensions/zoxide/
  • Search Directories command shows zoxide entries with scores
  • Typing a parent-directory fragment fuzzy-matches correctly
  • Enter opens terminal in selected directory
  • ctrl+e opens editor, ctrl+f opens file manager
  • ctrl+x removes entry from zoxide, ctrl+c copies path
  • Add Directory command with path argument adds to zoxide

Native zoxide integration for fuzzy directory jumping on Linux.

Uses Vicinae's built-in fuzzy filter via List.Item.keywords — each
directory entry carries the full path, every segment, and adjacent
segment pairs as keywords, so typing any fragment of any parent
directory matches naturally.

Features:
- Search all frecent directories from zoxide's database
- Open in terminal (autodetected), editor, file manager
- 5 configurable user program slots with ctrl+1..5 shortcuts
- Add/remove directories from zoxide's database
- Score display as accessories

Requires `zoxide` installed and on PATH.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant