Dotfiles management package
Project description
🗜 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.
Install with uv
Linux / macOS
curl -LsSf https://astral.sh/uv/install.sh | sh
uv tool install --upgrade --python 3.13 machineconfig
Windows
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
uv tool install --upgrade --python 3.13 machineconfig
Verify the install
mcfg --help
devops --help
machineconfig is also installed as an alias-style umbrella entrypoint alongside mcfg.
Command model
Machineconfig now exposes direct command families instead of a single old mcfg shell/config/dotfiles/... tree.
- Umbrella entrypoints:
mcfg,machineconfig - Direct entrypoints:
devops,cloud,sessions,agents,utils,fire,croshell,msearch
Current command families
| Command | What it covers |
|---|---|
devops |
install, repos, config, data, self, network, execute |
cloud |
sync, copy, mount, ftpx |
sessions |
run, run-aoe, attach, kill, create-from-function, balance-load, create-template, summarize |
agents |
parallel.{create, create-context, collect, make-template}, make-config, make-todo, make-symlinks, run-prompt, ask, add-skill |
utils |
kill-process, environment, get-machine-specs, init-project, upgrade-packages, type-hint, edit, download, pdf-merge, pdf-compress, read-db |
fire, croshell, msearch |
Standalone helper tools |
First steps
mcfg --help
devops --help
devops config shell
devops install --interactive
devops config sync --help
devops data sync --help
If you already know the package bundle you want, use:
devops install --group <group-name>
Repo-local usage
From a checkout of this repository, you can run the current CLI surface without installing globally:
UV_CACHE_DIR=/tmp/uv-cache uv run mcfg --help
UV_CACHE_DIR=/tmp/uv-cache uv run devops --help
Links
- Docs homepage:
docs/index.md - Installation guide:
docs/installation.md - Quickstart:
docs/quickstart.md
Author
Alex Al-Saffar. email
Contributor
Ruby Chan. email
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file machineconfig-8.84.tar.gz.
File metadata
- Download URL: machineconfig-8.84.tar.gz
- Upload date:
- Size: 759.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.0 {"installer":{"name":"uv","version":"0.11.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
b2b6e7494316d9c425ebf715c9a1e75ee910d07e377eb916ac05dd234a99973a
|
|
| MD5 |
dc3b6667b4c7ee2b2436f1eacd938525
|
|
| BLAKE2b-256 |
9a467224bacc27bd77b100f655df733b0e0fcf93b2f1bb8cc663c214d37b3269
|
File details
Details for the file machineconfig-8.84-py3-none-any.whl.
File metadata
- Download URL: machineconfig-8.84-py3-none-any.whl
- Upload date:
- Size: 1.0 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.0 {"installer":{"name":"uv","version":"0.11.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
6b58bc1112cd78b69096e782f291bae0bbef2f719df35d4736cac2175ae70ace
|
|
| MD5 |
480e5a01fa0af1370065ff277b611f60
|
|
| BLAKE2b-256 |
64c587fb879e7581d33270dcd08199c1d1d65fabaa5332c227aabfd63eb5566f
|
