Skip to content

Commands

Minseob Kim edited this page May 12, 2025 · 1 revision

dotato

All commands

> dotato danger unlink
> dotato export plan <group> <resolver>
> dotato export group <group> <resolver>
> dotato import plan <group> <resolver>
> dotato import group <group> <resolver>
> dotato init
> dotato unlink plan <group> <resolver>
> dotato unlink group <group> <resolver>
> dotato version

Terms

Term Meaning
dotfile A dotfile in a config directory that is having effect on the system.
dotato file or
dtt file
A file created by dotato that doesn't have effect on the system.
dotfile directory or
remote directory
A place where dotfile is.
dotato directory A place where dotato files and dotato config files are.
resolver

A string in `dotato.yaml` that tells about original path of dotato files.

It may contain tilde or env vars, so it is called 'resolver'.

dotato danger

dotato danger unlink

> dotato danger unlink

tl;dr: Reset all symlinks made by dotato in the PC

Dotato maintains a state file.

  • it is a sqlite file
  • it is at ~/.config/dotato/dotatostate.sqlite.
  • dotato stores all modification histories done by dotato to it.

What will happen:

  • Query histories related with link mode.
  • Replace symlinks with dotato files.
  • Dotato files will remain untouched.

dotato export

> dotato export plan <plan> <resolver>
> dotato export group <group> <resolver>

File mode

  • Select dotato files in each group folder.
  • Copy dotato files to resolved dotfile path.

Link mode

  • Select dotato files in each group folder.
  • Create symlinks at resolved dotfile path that point to your dotato files.

dotato import

> dotato import plan <plan> <resolver>
> dotato import group <group> <resolver>

File mode

  • Select dotfiles in each remote folder.
  • Copy dotfiles to corresponding dotato path.

Link mode

  • Select dotfiles in each remote folder.
  • Move dotfiles to corresponding dotato path and create symlinks instead.

dotato init

Create example dotato.yaml file if there isn't config file.

dotato unlink

> dotato unlink plan <plan> <resolver>
> dotato unlink group <group> <resolver>

Note

dotato unlink command works only in link mode.

  • Replace symlinks with dotato files.
  • Dotato files will remain untouched.

dotato version

> dotato version

Check version of the binary file.

Clone this wiki locally