Metadata-Version: 2.4
Name: machineconfig
Version: 8.86
Summary: Dotfiles management package
Author-email: Alex Al-Saffar <programmer@usa.com>
License: Apache 2.0
Project-URL: Homepage, https://github.com/thisismygitrepo/machineconfig
Project-URL: Bug Tracker, https://github.com/thisismygitrepo/machineconfig/issues
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.13
Description-Content-Type: text/markdown
Requires-Dist: cryptography>=46.0.5
Requires-Dist: fire>=0.7.1
Requires-Dist: gitpython>=3.1.46
Requires-Dist: joblib>=1.5.3
Requires-Dist: paramiko>=4.0.0
Requires-Dist: psutil>=7.2.2
Requires-Dist: pyyaml>=6.0.3
Requires-Dist: questionary>=2.1.1
Requires-Dist: randomname>=0.2.1
Requires-Dist: rclone-python>=0.1.24
Requires-Dist: requests>=2.32.5
Requires-Dist: rich>=14.3.3
Requires-Dist: tenacity>=9.1.4
Requires-Dist: typer>=0.24.1
Provides-Extra: windows
Provides-Extra: plot

# 🗜 Machineconfig

Machineconfig is a cross-platform CLI for bootstrapping and maintaining a development machine. It groups package installation, config syncing, data syncing, session automation, and helper utilities into one install.

See the [online docs](https://thisismygitrepo.github.io/machineconfig/) for full usage and reference material.

## Install with `uv`

### Linux / macOS

```bash
curl -LsSf https://astral.sh/uv/install.sh | sh
uv tool install --upgrade --python 3.14 machineconfig
```

### Windows

```powershell
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
uv tool install --upgrade --python 3.14 machineconfig
```

## Repo-local usage

From a checkout of this repository, you can run the current CLI surface without installing globally:

```bash
UV_CACHE_DIR=/tmp/uv-cache uv run mcfg --help
UV_CACHE_DIR=/tmp/uv-cache uv run devops --help
```

## Quick init

devops install --group sysabc  # Install (if missing) package manager (apt, brew, winget)
devops config copy-assets all  # copy config files to machine
devops config sync down --sensitivity public --method copy --on-conflict overwrite-default-path --which all  # link config files
devops config terminal config-shell --which default  # add alias to shell
devops install --group termabc  # install the basic terminal cli's


## Author

Alex Al-Saffar. [email](mailto:programmer@usa.com)

## Contributor

Ruby Chan. [email](mailto:ruby.chan@sa.gov.au)
