A tiny CLI to bookmark project folders under short names and open them instantly in your favorite editor.
thyra is designed for developers who hop between multiple projects and want a faster, keyboard-only way to jump straight into a folder—no file explorer, no hassle.
- Save any directory under a short, memorable name
- Import multiple project folders from a parent directory
- Open saved directories instantly from the terminal
- Check the CLI version easily (
thyra version) - Works with any editor (VS Code, WebStorm, Vim, Sublime Text, Emacs, etc.)
- Stores configuration in your user directory
- Cross-platform: macOS, Linux, Windows
- Simple, fast, no fluff
npm install -g thyraRequires Node.js v18+.
After install, the thyra command will be available system-wide.
# Save projects
thyra config blog ~/projects/personal-blog
thyra config api /var/www/company/api
# Import projects from a directory
thyra import ~/projects
# Open instantly
thyra open blog
# See everything you saved
thyra list
# Check thyra version
thyra versionthyra config <name> <path>Examples
thyra config blog ~/projects/personal-blog
thyra config api /var/www/company/apithyra import <directory>Example
thyra import ~/projectsThis scans the target directory, registers each project folder it finds, and skips entries that already exist.
thyra open <name>Example
thyra open blogThis opens the saved path in your configured editor.
thyra listSample output
blog → /Users/you/projects/personal-blog
api → /var/www/company/api
thyra --versionOutput
v1.3.0
This shows the currently installed version of thyra.
thyra update <name> <path>Update the stored path for an existing alias. The folder must exist on disk.
Example
thyra update blog ~/projects/personal-blog-v2thyra remove <name>Remove an alias from your saved mappings. This cannot be undone except by re-running thyra config.
Example
thyra remove apiYou can also remove all saved projects at once using the --all flag. By default this prompts for confirmation; pass --force to skip the prompt.
# Prompt for confirmation
thyra remove --all
# Skip confirmation
thyra remove --all --forcethyra --helpBy default, thyra uses VS Code (code) if it’s available.
To use a different editor, set the EDITOR environment variable:
# one-off for current shell
EDITOR=webstorm thyra open blog
# or set it permanently (bash/zsh)
export EDITOR=webstorm| Editor | Command |
|---|---|
| Visual Studio Code | code |
| WebStorm | webstorm |
| PhpStorm | pstorm |
| Vim / Neovim | vim, nvim |
| Sublime Text | subl |
| Emacs | emacs |
Tip (Windows, PowerShell):
setx EDITOR "webstorm"thyra stores your mappings in a JSON file:
| Platform | Path |
|---|---|
| macOS / Linux | ~/.config/thyra/thyra.json |
| Windows | %APPDATA%\thyra\thyra.json |
Each entry maps a name → absolute path.
When you run thyra open <name>:
- thyra reads the target path from the config
- thyra launches your editor with that directory
# Save projects
thyra config frontend ~/code/myapp/frontend
thyra config backend ~/code/myapp/backend
thyra config docs ~/code/myapp/docs
# Hop around instantly
thyra open frontend
thyra open backend
thyra open docs
# View all
thyra list
# Check thyra version
thyra version-
Command not found Ensure global npm binaries are on your PATH. On macOS/Linux, this is often
$HOME/.npm-global/binor the Node version manager’s bin directory. -
Editor doesn’t open Confirm the editor command works by itself (e.g., run
webstorm .orcode .in any folder). If it does, setEDITORto that command. -
Paths with spaces Wrap the path in quotes when configuring:
thyra config design "/Users/you/Work/Client A/Design"
npm uninstall -g thyraYour config file is left in place so you can reinstall later. Remove it manually if you want a clean slate.
cli, command-line, open-folder, project-manager, developer-tools, shortcuts, vscode, jetbrains, vim, productivity, workspace, folder-alias
- Email: udithavithanage358@gmail.com
- GitHub: github.com/udithavithanage
MIT License – You are free to use, modify, and distribute this tool.