otty / apps

All apps/Pijul

Pijul

pijul

A distributed version control system built on a mathematically sound theory of patches.

Runs as pijul|macOS, Linux, Windows|pijul.org

Open form in Otty otty.toml

Sync rules

What travels, what stays, what never leaves

Pijul in your home directory Every rule on this page, by file

· config.toml Sync

· identity.toml Sync

· secret_key.json Never synced

Only what the catalog names. A directory that syncs brings everything inside it except what is listed as excluded here.

apps/pijul/otty.tomlThe file this page is generated from

id = "pijul"

name = "Pijul"

homepage = "https://pijul.org"

description = "A distributed version control system built on a mathematically sound theory of patches."

executables = ["pijul"]

[dotfiles]

# https://pijul.org/manual/configuration.html — "The location of Pijul's global

# configuration depends on the conventions of the user's operating system;

# Pijul will first try to instantiate a global configuration in the user's

# configuration directory according to [this table]", linking

# https://docs.rs/dirs-next/2.0.0/dirs_next/fn.config_dir.html: $XDG_CONFIG_HOME

# or $HOME/.config on Linux, $HOME/Library/Application Support on macOS,

# %APPDATA% on Windows — that table is [appData]. "If pijul cannot access the

# conventional config location, it will fall back to the home directory, using

# $HOME/.config/pijul."

# https://docs.rs/pijul-identity/latest/pijul_identity/ draws the layout below

# that directory: config.toml holds the global defaults (username, full name,

# email), and identities/<name>/identity.toml holds one identity's username,

# full name, email and public key.

paths = [

"[appData]/pijul/config.toml",

"[appData]/pijul/identities/*/identity.toml",

]

exclude = []

# Same page: beside each identity.toml is a secret_key.json holding the

# identity's version, algorithm and key. That key is what signs a change —

# whole file.

secret = ["[appData]/pijul/identities/*/secret_key.json"]

# No machine_lines: the documented config.toml keys are colors, pager,

# unrecord_changes, author, template and ignore_kinds — preferences and an

# identity, none of them a property of one machine.

[commands]

format = 1

label = "Pijul"

description = "Record changes and move them between repositories. Channels, remotes, diff, log and unrecord are left out."

quality = "ai-draft"

base = "fig:pijul"

parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = true, short_bundles = true }

[[commands.source]]

id = "fig"

kind = "completion"

url = "https://github.com/withfig/autocomplete/blob/master/src/pijul.ts"

license = "MIT"

[[commands.subcommand]]

path = ["record"]

label = "Record a change"

description = "Create a change from the working copy."

[[commands.subcommand.source]]

id = "fig"

kind = "completion"

url = "https://github.com/withfig/autocomplete/blob/master/src/pijul.ts"

license = "MIT"

[[commands.subcommand.field]]

id = "message"

label = "Message"

type = "string"

option = ["--message", "-m"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "all"

label = "Record all paths"

type = "boolean"

option = ["--all", "-a"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "author"

label = "Author"

type = "string"

option = ["--author"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "channel"

label = "Channel"

type = "string"

option = ["--channel"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "ignore_missing"

label = "Ignore missing files"

type = "boolean"

option = ["--ignore-missing"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "amend"

label = "Amend change"

type = "string"

option = ["--amend"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "prefixes"

label = "Paths"

type = "string"

position = 0

multiple = true

sources = ["fig"]

[[commands.subcommand.task]]

id = "record"

label = "Record everything"

set = { all = [true] }

fields = ["message", "all", "author", "channel"]

required = ["message"]

[[commands.subcommand.group]]

id = "basic"

label = "Basic"

fields = ["message", "all", "author", "channel"]

[[commands.subcommand.group]]

id = "advanced"

label = "Advanced"

fields = ["ignore_missing", "amend", "prefixes"]

[[commands.subcommand]]

path = ["clone"]

label = "Clone a repository"

[[commands.subcommand.source]]

id = "fig"

kind = "completion"

url = "https://github.com/withfig/autocomplete/blob/master/src/pijul.ts"

license = "MIT"

[[commands.subcommand.field]]

id = "remote"

label = "Remote"

type = "string"

position = 0

sources = ["fig"]

[[commands.subcommand.field]]

id = "target"

label = "Target path"

type = "string"

position = 1

sources = ["fig"]

[[commands.subcommand.field]]

id = "channel"

label = "Channel"

type = "string"

option = ["--channel"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "change"

label = "Single change"

type = "string"

option = ["--change"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "state"

label = "State"

type = "string"

option = ["--state"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "partial_path"

label = "Only this path"

type = "string"

option = ["--path"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "insecure"

label = "Skip certificate check"

type = "boolean"

option = ["-k"]

sources = ["fig"]

[[commands.subcommand.task]]

id = "clone"

label = "Clone"

fields = ["remote", "target", "channel", "change", "state", "partial_path", "insecure"]

required = ["remote"]

[[commands.subcommand.group]]

id = "basic"

label = "Basic"

fields = ["remote", "target", "channel"]

[[commands.subcommand.group]]

id = "advanced"

label = "Advanced"

fields = ["change", "state", "partial_path", "insecure"]

[[commands.subcommand]]

path = ["init"]

label = "Initialise a repository"

[[commands.subcommand.source]]

id = "fig"

kind = "completion"

url = "https://github.com/withfig/autocomplete/blob/master/src/pijul.ts"

license = "MIT"

[[commands.subcommand.field]]

id = "path"

label = "Directory"

type = "path"

position = 0

path = { kind = "directory", role = "output" }

sources = ["fig"]

[[commands.subcommand.field]]

id = "kind"

label = "Project kind"

type = "string"

option = ["--kind", "-k"]

suggestions = [{ value = "rust", label = "rust" }]

sources = ["fig"]

[[commands.subcommand.field]]

id = "channel"

label = "Channel"

type = "string"

option = ["--channel"]

sources = ["fig"]

[[commands.subcommand.task]]

id = "init"

label = "Initialise"

fields = ["path", "kind", "channel"]

required = []

[[commands.subcommand.group]]

id = "basic"

label = "Basic"

fields = ["path", "kind", "channel"]

[[commands.subcommand]]

path = ["push"]

label = "Push changes"

[[commands.subcommand.source]]

id = "fig"

kind = "completion"

url = "https://github.com/withfig/autocomplete/blob/master/src/pijul.ts"

license = "MIT"

[[commands.subcommand.field]]

id = "remote"

label = "Remote"

type = "string"

position = 0

sources = ["fig"]

[[commands.subcommand.field]]

id = "all"

label = "Push all changes"

type = "boolean"

option = ["--all", "-a"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "from_channel"

label = "From channel"

type = "string"

option = ["--from-channel"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "to_channel"

label = "To channel"

type = "string"

option = ["--to-channel"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "only_path"

label = "Only this path"

type = "string"

option = ["--path"]

sources = ["fig"]

[[commands.subcommand.task]]

id = "push"

label = "Push all"

set = { all = [true] }

fields = ["remote", "all", "from_channel", "to_channel", "only_path"]

required = ["remote"]

[[commands.subcommand.group]]

id = "basic"

label = "Basic"

fields = ["remote", "all", "from_channel", "to_channel", "only_path"]

[[commands.subcommand]]

path = ["pull"]

label = "Pull changes"

[[commands.subcommand.source]]

id = "fig"

kind = "completion"

url = "https://github.com/withfig/autocomplete/blob/master/src/pijul.ts"

license = "MIT"

[[commands.subcommand.field]]

id = "remote"

label = "Remote"

type = "string"

position = 0

sources = ["fig"]

[[commands.subcommand.field]]

id = "all"

label = "Pull all changes"

type = "boolean"

option = ["--all", "-a"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "from_channel"

label = "From channel"

type = "string"

option = ["--from-channel"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "to_channel"

label = "To channel"

type = "string"

option = ["--to-channel"]

sources = ["fig"]

[[commands.subcommand.field]]

id = "full"

label = "Download full changes"

type = "boolean"

option = ["--full"]

sources = ["fig"]

[[commands.subcommand.task]]

id = "pull"

label = "Pull all"

set = { all = [true] }

fields = ["remote", "all", "from_channel", "to_channel", "full"]

required = ["remote"]

[[commands.subcommand.group]]

id = "basic"

label = "Basic"

fields = ["remote", "all", "from_channel", "to_channel", "full"]

Use it with your dotfile manager

Same data, in the shape your tool already reads

Opens Otty and adds this tool to what it syncs

Opens otty://sync/add/pijul. Otty ships with this catalog, so the link only has to name the tool — nothing is downloaded.

Every one of these keeps the credential file out.