mntn 3.0.1

A Rust-based command-line tool for dotfiles management with profiles.
Documentation 
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
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57

# mntn

mntn is built to keep your dotfiles organized, safe, and consistent across machines using profiles.

A profile is a named set of configuration choices that represents a context, like work, personal, or minimal. With profiles, you can keep multiple setups and switch between them so the right settings are active for the situation.

At a high level, mntn helps you manage these configurations, keep them in sync, and recover them when needed.

![Demo Video](./assets/mntn.gif)

## Quick Start

```bash
mntn backup
mntn restore
mntn validate
```

Switch profiles:

```bash
mntn profile create work --description "Work setup"
mntn use work
```

## Core Commands

- `backup` - copy tracked configs into `~/.mntn/backup/`
- `restore` - restore configs from backup
- `validate` - check registry files and config drift
- `profile` - list/create/delete profiles
- `use` - switch active profile
- `git` - run any git command inside `~/.mntn`
- `sync` - run `git add .`, `git commit -m "chore: sync mntn"` (with `--message` to override), and `git push` inside `~/.mntn`

## Directory Layout

```text
~/.mntn/
├── backup/
│   ├── common/
│   └── profiles/
├── profiles.json
├── .active-profile
├── config.registry.json
├── package.registry.json
└── encrypted.registry.json
```

Registry notes:
- `config.registry.json` tracks regular dotfiles and their targets.
- `package.registry.json` tracks package managers and how to export package lists.
- `encrypted.registry.json` tracks sensitive files that are stored encrypted.

## License

GNU General Public License v3.0 or later (GPL-3.0-or-later), published by the Free Software Foundation.