Installation
Installing the Package
Open the Julia REPL and run:
using Pkg
Pkg.add(url="https://github.com/Tomonori-Tanaka/Magesty.jl")Installing CLI Tools
Magesty.jl provides command-line tools (e.g. vasp2extxyz). To install wrapper scripts into ~/.julia/bin, run once from the Julia REPL:
using Magesty
install_tools()Adding ~/.julia/bin to PATH
The wrapper scripts are placed in ~/.julia/bin by default. Add the directory to your PATH so the commands are available in your shell.
Linux / macOS
Add the following line to your shell configuration file (~/.bashrc, ~/.zshrc, etc.):
export PATH="$HOME/.julia/bin:$PATH"Then reload the file:
source ~/.bashrc # or ~/.zshrcWindows
The CLI wrappers generated by install_tools() are Unix shell scripts (#!/bin/sh) and are not directly executable on Windows. Use Linux/macOS (or WSL) for the CLI tools.
If you are using WSL (Windows Subsystem for Linux), follow the Linux instructions above inside your WSL terminal.
To add the directory to PATH on native Windows for future Julia-based tools, open PowerShell and run:
[System.Environment]::SetEnvironmentVariable(
"PATH",
"$env:USERPROFILE\.julia\bin;" + [System.Environment]::GetEnvironmentVariable("PATH", "User"),
"User"
)This adds %USERPROFILE%\.julia\bin persistently to your user PATH.