Repository: busterc/xcv
Branch: master
Commit: 88f17c27a314
Files: 3
Total size: 4.5 KB
Directory structure:
gitextract_827w55_2/
├── README.md
├── package.json
└── xcv
================================================
FILE CONTENTS
================================================
================================================
FILE: README.md
================================================
# xcv
Cut, Copy and Paste files with Bash
```sh
$ xcv
Usage: $ xcv <x|c|v|l> [options]
Description:
xcv wraps the cp, mv and ls built in commands, however
cutting (x) and copying (c) do not require a target directory, while
pasting (v) and listing (l) do not require a source directory, because all selected
files are placed into, listed and pulled from:
$HOME/.xcv
Options:
x Cut files, using the mv command options
c Copy files, using the cp command options
v Paste files into the current working directory
l List files available for pasting, using the ls command options
```
## Homebrew Installation
```sh
$ brew install xcv
```
## Bpkg Installation
With [bpkg](https://github.com/bpkg/bpkg) do:
```sh
$ bpkg install busterc/xcv
```
## NPM Installation
```sh
$ npm install xcv --global
```
## Nifty Aliases
```sh
alias fsx="xcv x"
alias fsc="xcv c"
alias fsv="xcv v"
alias fsl="xcv l"
```
## Walkthrough Example
1. Start with a directory of files
```sh
$ find .
./a.txt
./b.txt
./c
./c/d.txt
```
1. Then, **copy** all the files recursively
```sh
$ xcv c -R .
```
1. Then, **list** the _copied_ files
```sh
$ xcv l
a.txt b.txt c
```
1. Then, change directories and **paste** in the _copied_ files
```sh
$ cd ~/elsewhere
$ xcv v
```
1. Then, list the _pasted_ files in the CWD, along with any pre-existing files
```sh
$ ls
a.txt b.txt c x.txt
```
1. Then, **cut** all the files in the CWD
```sh
$ xcv x *
```
1. Then, notice all the files have been _cut_ out
```sh
$ ls
```
1. Then, change directories and **paste** in the _cut_ files
```sh
$ cd ~/somewhere
$ xcv v
```
1. Then, list the _pasted_ files in the CWD, along with any pre-existing files
```sh
$ ls
a.txt b.txt c x.txt y.txt
```
## License
ISC License (ISC)
Copyright © 2015, Buster Collings
Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
================================================
FILE: package.json
================================================
{
"name": "xcv",
"version": "1.0.1",
"description": "Cut, Copy and Paste files with Bash",
"preferGlobal": true,
"global": true,
"install": "install -c xcv ${PREFIX:-/usr/local}/bin",
"bin": {
"xcv": "xcv"
},
"repository": {
"type": "git",
"url": "https://github.com/busterc/xcv"
},
"keywords": [
"xcv",
"cut",
"copy",
"paste",
"move",
"files",
"bash",
"cli",
"cp",
"mv",
"shell"
],
"author": "Buster Collings",
"license": "ISC",
"bugs": {
"url": "https://github.com/busterc/xcv/issues"
},
"homepage": "https://github.com/busterc/xcv"
}
================================================
FILE: xcv
================================================
#!/bin/bash
# CLI Cut, Copy, Paste files, for bash
function xcv() {
unset GLOBIGNORE
shopt -s dotglob
local options=""
local xcvdir="$HOME/.xcv"
mkdir -p "$xcvdir"
function rmxcv() {
rm -rf "$xcvdir"
mkdir -p "$xcvdir"
}
local action=$1
shift
case "$action" in
x)
# Cut files
if [[ $# -lt 1 ]]; then
printf >&2 "Error Cutting: not enough options\n\n"
xcv
else
rmxcv
mv "$@" "$xcvdir"
fi
;;
c)
# Copy files
if [[ $# -lt 1 ]]; then
printf >&2 "Error Copying: not enough options\n\n"
xcv
else
rmxcv
cp "$@" "$xcvdir"
fi
;;
v)
# Paste files
cp -r "$xcvdir"/* .
rmxcv
;;
l)
# List files available for pasting
ls "$@" "$xcvdir"
;;
*)
cat <<EOF
Usage: $ xcv <x|c|v|l> [options]
Description:
xcv wraps the cp, mv and ls built in commands, however
cutting (x) and copying (c) do not require a target directory, while
pasting (v) and listing (l) do not require a source directory, because all selected
files are placed into, listed and pulled from:
$HOME/.xcv
Options:
x Cut files, using the mv command options
c Copy files, using the cp command options
v Paste files into the current working directory
l List files available for pasting, using the ls command options
EOF
;;
esac
}
xcv "$@"
gitextract_827w55_2/ ├── README.md ├── package.json └── xcv
Condensed preview — 3 files, each showing path, character count, and a content snippet. Download the .json file or copy for the full structured content (5K chars).
[
{
"path": "README.md",
"chars": 2621,
"preview": "# xcv\n\nCut, Copy and Paste files with Bash\n\n```sh\n$ xcv\nUsage: $ xcv <x|c|v|l> [options]\n\n Description:\n xcv wraps t"
},
{
"path": "package.json",
"chars": 631,
"preview": "{\n \"name\": \"xcv\",\n \"version\": \"1.0.1\",\n \"description\": \"Cut, Copy and Paste files with Bash\",\n \"preferGlobal\": true,"
},
{
"path": "xcv",
"chars": 1396,
"preview": "#!/bin/bash\n\n# CLI Cut, Copy, Paste files, for bash\nfunction xcv() {\n unset GLOBIGNORE\n shopt -s dotglob\n\n local opti"
}
]
About this extraction
This page contains the full source code of the busterc/xcv GitHub repository, extracted and formatted as plain text for AI agents and large language models (LLMs). The extraction includes 3 files (4.5 KB), approximately 1.5k tokens. Use this with OpenClaw, Claude, ChatGPT, Cursor, Windsurf, or any other AI tool that accepts text input. You can copy the full output to your clipboard or download it as a .txt file.
Extracted by GitExtract — free GitHub repo to text converter for AI. Built by Nikandr Surkov.