Skip to main content

🗜 StackOps

Developer workstation and workflow CLI.

Docs PyPI package Python 3.14+ Installed with uv

https://github.com/user-attachments/assets/c3e68bc4-88b7-4354-8fe5-b56bbfb98ad8

StackOps coordinates packages, configuration, repositories, data, terminal layouts, and coding-agent resources around the tools you already use. Install selected packages, synchronize declared configuration, or launch an authored tmux workspace through focused commands. Available installers and integrations vary by operating system and external tool.

Before After
Fresh minimal machine state Developer-ready machine state

See the online docs for full usage and reference material.

Install

Choose your platform and expand only the commands you need.

Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
uv tool install --upgrade --python 3.14 stackops
stackops --help
macOS
curl -LsSf https://astral.sh/uv/install.sh | sh
uv tool install --upgrade --python 3.14 stackops
stackops --help
Windows PowerShell
powershell -ExecutionPolicy Bypass -c "irm https://astral.sh/uv/install.ps1 | iex"
uv tool install --upgrade --python 3.14 stackops
stackops --help

Codex Skill

Install the StackOps skill for Codex with:

bunx skills add thisismygitrepo/stackops --skill stackops --global --agent codex --yes

Any agent can read the same guide for the installed version without installing the skill:

stackops --skill

Start with a workflow

Inspect the commands for the workflow you need:

devops software install --help
devops config dotfiles sync --help
terminal run --help

The quickstart shows a selected-package example and configuration options.

Optional workstation setup

This broader setup installs system and terminal package groups, copies bundled assets, applies public configuration mappings, and configures the default shell. Use it when you want those workstation conventions; existing customized systems can use individual commands instead. Package-group behavior depends on the platform and may invoke privileged package managers.

devops software install --group sysabc
devops config copy-assets all
devops config dotfiles sync down \
  --source library \
  --method copy \
  --on-conflict throw-error \
  --which all
devops config terminal config-shell --shell default
devops software install --group termabc

The scripted sync above copies configuration and stops on conflicts. The public copy/symlink choices in devops config interactive use overwrite-default-path and can replace existing targets; they are a different setup choice.

CLI

StackOps exposes standalone commands and an umbrella wrapper:

Command Purpose
devops Package installation, repo automation, config/data sync, self-management, networking, script execution, vault
cloud Cloud sync, copy, mount, SSH transfer, and OneDrive helpers
terminal Terminal session and layout management
agents AI agent scaffolding, MCP catalog installs, prompt runs, parallel workflows
utils General-purpose utility commands
fire File, function, notebook, and app runner
preview File preview and uv run backend launcher
seek Interactive search across files, text matches, and symbols
stackops Umbrella wrapper that routes into all of the above

Run <command> --help for details, or stackops --help to see the command families.

Author

Alex Al-Saffar. email

Contributor

Ruby Chan. email

Metadata

Release files for stackops 26.11.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for stackops 26.11.1
File Size Uploaded Provenance Actions
stackops-26.11.1.tar.gz 4.3 MB Without provenance Details for stackops-26.11.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for stackops 26.11.1
File Interpreter ABI Platform Actions
stackops-26.11.1-py3-none-any.whl Python 3 none any Details for stackops-26.11.1-py3-none-any.whl

Total release size: 6.6 MB

Release files / stackops-26.11.1.tar.gz

Download URL stackops-26.11.1.tar.gz
Size 4.3 MB
Tags Source
SHA-256 checksum
How to use checksums
6c76c4085b63761ed1f4fd955b2c4a4c568586ee193a7230c218d5a524b94279
BLAKE2b-256 checksum
How to use checksums
e74c64945bb2c096c50e96ff24fbece67efab5389d1990f0f31f49f875d5d4b3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.7 {"installer":{"name":"uv","version":"0.13.7","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}

Release files / stackops-26.11.1-py3-none-any.whl

Download URL stackops-26.11.1-py3-none-any.whl
Size 2.3 MB
Tags Python 3
SHA-256 checksum
How to use checksums
ac46eb8166d4a81e866a7763caf418e7c9842e3fbc36d553d17cd58d7c0cec5d
BLAKE2b-256 checksum
How to use checksums
0c9a1d8292ff1f7a7ad8c7332a96839c44b1980e6e230343edf54a046499e90c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.7 {"installer":{"name":"uv","version":"0.13.7","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}

Security for stackops 26.11.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

26.11.1 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page