Symlink Manager

Cross-platform symlink management CLI with shell support for pwsh, bash, zsh, fish, and cmd.

Features

• Create, remove, and list symlinks
• Git integration (init, create repo, commit & push)
• Shell completion scripts for PowerShell, Bash, Zsh, and Fish
• Interactive prompts with @clack/prompts
• Cross-platform support (Windows, macOS, Linux)

Installation

# Using bun
bun add @wrikka/symlink

# Or install globally
bun add -g @wrikka/symlink

Usage

Create a symlink

# Interactive mode
symlink create

# With options
symlink create -s /path/to/source -t /path/to/link

# Force overwrite
symlink create -s /path/to/source -t /path/to/link --force

Remove a symlink

# Interactive mode
symlink remove

# Direct
symlink remove -t /path/to/link

List symlinks

# Current directory
symlink list

# Specific directory
symlink list -d /path/to/scan

Git integration

# Initialize git repo
symlink git init

# Create remote repo
symlink git create -n my-repo -d "My repository"

# Commit and push
symlink git push -m "Initial commit"

Shell completion

# Install for current shell
symlink shell install

# Install for specific shell
symlink shell install -s bash

Commands

| Command | Description | |---------|-------------| | symlink create | Create a new symlink | | symlink remove | Remove a symlink | | symlink list | List all symlinks | | symlink git init | Initialize git repository | | symlink git create | Create remote repository | | symlink git push | Commit and push changes | | symlink shell install | Install shell completion |

Options

| Option | Description | |--------|-------------| | -s, --source <path> | Source path | | -t, --target <path> | Target path | | -f, --force | Force overwrite | | -i, --interactive | Interactive mode | | -d, --directory <path> | Directory to scan | | -m, --message <msg> | Commit message | | -a, --all | Stage all changes | | -n, --name <name> | Repository name | | -p, --private | Create private repository |

Development

# Install dependencies
bun install

# Type checking
bun run typecheck

# Build
bun run build

# Test
bun test

# Development mode
bun run dev

# Lint
bun run lint

# Format
bun run format

License

MIT