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.3

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.3
File Size Uploaded Provenance Actions
stackops-26.11.3.tar.gz 4.3 MB Without provenance Details for stackops-26.11.3.tar.gz

Built distribution (wheel)

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

Total release size: 6.6 MB

Release files / stackops-26.11.3.tar.gz

Download URL stackops-26.11.3.tar.gz
Size 4.3 MB
Tags Source
SHA-256 checksum
How to use checksums
c8c2c76b5ef55cd288e5aca9a80d6f599fa4ccab46d5f77bb27f373470f5e60e
BLAKE2b-256 checksum
How to use checksums
e4b880b1b3648610a93195d9b1229b41df325339d040a736398ec43bd6657500
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.3-py3-none-any.whl

Download URL stackops-26.11.3-py3-none-any.whl
Size 2.3 MB
Tags Python 3
SHA-256 checksum
How to use checksums
a92f0f00bf32089ed9abdb1a64a4c801a71c72c20b0d224bb75303edb5bb8dbc
BLAKE2b-256 checksum
How to use checksums
7eeaa78e4c9e42f21f5d6d59111c67727d70bc836394f4d6a6411a1feb07494e
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.3

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.3 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