aboutsummaryrefslogtreecommitdiffstats
path: root/README.md
blob: 7f881b7fc1bd405b712a784fe65f2e712842a7ce (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
# Auto .file manager
Auto.s is a dotfile manager written in posix sh. It's main goal is to provide a
simple way to manage your dotfiles without leaving a footprint when it's done.
## How to
For information on arguments run: `auto. -h`
### topography
Auto.s uses a custom file format which is used to define what you want to do.
Currently the topography format supports 4 options which may be used like so:
```topography
# a comment

$$ echo "a shell command"

# copying files
filea -> fileb

# the copy command may also be prefixed with a # like so:
filea #-> fileb
# which will copy the file as root

# installing programs
:: neovim,firefox,neofetch
```

The main advantage of using the custom options over a simple shell script is the
ability to uninstall and install using just one line.

> [!Important]
> The `::` option is currently only supported on voidlinux, archlinux, and
> debian. If you would like to expand compatibility send [me](mailto:me@zacharyscheiman.com) a patch.