pr-descriptions

linux

```bash

curl -fsSL https://get.comtrya.dev | sh

comtrya -d https://github.com/airtonix/dotfiles apply

```

macos

```bash

curl -fsSL https://get.comtrya.dev | sh

comtrya -d https://github.com/airtonix/dotfiles apply

```

windows

first open powershell as admin and run:

```powershell

Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux,VirtualMachinePlatform -All -NoRestart

```

then reboot. yes stop crying. just do it.

After rebooting, run:

```powershell

iwr "https://get.comtrya.dev/ps" -UseBasicParsing | iex

comtrya -d https://github.com/airtonix/dotfiles apply

```

Above would be useful if comtrya was perfect. However you may instead need to install individual parts:

```sh

$env:PATH+=";$env:USERPROFILE\.comtrya"

cd C:\Users\zeno.jiricek\AppData\Local\comtrya\manifests\git\githubcomairtonixdotfiles

comtrya apply -m manifest.dot.notated.path.instead.of.slash.notated.paths

```

This is mostly a reminder for myself.

```sh

dotfiles apply # applies all changes

dotfiles apply zsh # applies only zsh related changes

dotfiles apply powershell # applies only powershell related changes

# with or without commas

dotfiles apply devtools.opencode,windowmanagers.sway # applies only devtools and sway window manager related changes

dotfiles apply devtools.opencode windowmanagers.sway # applies only devtools and sway window manager related changes

```

---

# Comtrya Quick Reference

| Command | Description |

|---------|-------------|

| comtrya apply | Apply all manifests in current directory |

| comtrya -d ./path apply | Apply manifests from specific directory |

| comtrya -d ./ apply -m one,two,three | Apply specific manifests by name |

| comtrya status | List manifest status |

| comtrya contexts | List available contexts |

| comtrya contexts --show-values | Show context values |

| comtrya version | Print version information |

| comtrya help | Print help information |

| comtrya gen-completions | Auto generate shell completions |

binary.github

Download binary from GitHub

```yaml

• action: binary.github

name: comtrya # binary name locally

directory: /usr/local/bin # save location

repository: comtrya/comtrya # github repo

version: v0.8.7 # version/tag

```

command.run (alias: cmd.run)

Run arbitrary commands

```yaml

• action: command.run

command: echo

args:

- "Hello world"

dir: . # working directory (optional)

privileged: false # elevate privileges (optional)

env: # scoped env vars (optional)

VAR_NAME: value

```

file.copy

Copy file from files directory to destination

```yaml

• action: file.copy

from: config_file # source (under files/)

to: "{{ user.config_dir }}/app" # destination

template: false # render with context (optional)

chmod: 644 # octal permissions (optional)

owned_by_user: username # chown user (optional, needs root)

owned_by_group: groupname # chown group (optional, needs root)

```

file.download

Download file from URL

```yaml

• action: file.download

from: https://example.com/file

to: /tmp/file

owned_by_user: user # chown (optional, needs root)

owned_by_group: group # chown (optional, needs root)

```

file.link

Create symlinks

```yaml

# Single file

• action: file.link

from: /root/symlink # symlink location

to: managed_file # what it points to

# Directory walk

• action: file.link

source: walker

target: /tmp/walker-123

walk_dir: true # walk directory

```

file.remove

Remove file

```yaml

• action: file.remove

target: /tmp/some-file

```

file.unarchive

Extract tar.gz archives

```yaml

• action: file.una