# Stow

> GNU Stow — symlink farm manager for dotfiles

- Skill: `javimosch/stow` (Agent Skill)
- Install (CLI): `npx skillmds@latest add javimosch/stow`
- Raw SKILL.md: https://api.skillmd.com/api/skills/javimosch/stow/raw
- Safety review: PASS (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: javimosch (https://skillmd.com/u/javimosch)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/javimosch/stow

---


# stow Plugin

GNU Stow manages packages of software and their associated config files from a central directory using symlinks.

## Commands

- `stow _ _` — Passthrough to stow CLI

## Usage

### Basic Commands

```bash
# Stow a package (create symlinks from target to stow dir)
stow _ _ <package>

# Unstow a package (remove symlinks)
stow _ _ -D <package>

# Restow (unstow then stow again)
stow _ _ -R <package>

# Target a specific directory
stow _ _ -t /target/dir <package>

# Dry run (show what would happen)
stow _ _ -n <package>

# Verbose output
stow _ _ -v <package>
```

### Dotfile Management Example

```bash
# ~/dotfiles/
# ├── bash/
# │   └── .bashrc
# ├── git/
# │   ├── .gitconfig
# │   └── .gitignore_global
# └── nvim/
#     ├── .config/
#     │   └── nvim/
#     │       └── init.lua

# Stow specific package
stow _ _ bash
stow _ _ git
stow _ _ nvim

# Unstow a package
stow _ _ -D bash

# Restow all
stow _ _ -R bash git nvim
```

## Key Features
- **Symlink management** — Create and remove symlink farms
- **Dotfile management** — Organized dotfile deployment
- **Package management** — Manage installed packages
- **Conflict detection** — Detects conflicting symlinks
- **Dry run mode** — Preview changes before applying
- **Selective targeting** — Stow to specific directories
- **Adopt mode** — Move existing files into stow directory

## Notes
- Stow NEVER touches files outside the target directory
- Works with any directory structure (not just dotfiles)
- Uses relative symlinks when possible (stow directory under target)
- Default target is parent of the stow directory