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

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

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.10.4
File Size Uploaded Provenance Actions
stackops-26.10.4.tar.gz 1.6 MB Without provenance Details for stackops-26.10.4.tar.gz

Built distribution (wheel)

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

Total release size: 3.8 MB

Release files / stackops-26.10.4.tar.gz

Download URL stackops-26.10.4.tar.gz
Size 1.6 MB
Tags Source
SHA-256 checksum
How to use checksums
28372236b41848aeb128da2ac03ab67df5dc29c605cd469db7096acda6b6819d
BLAKE2b-256 checksum
How to use checksums
f596b316131ae7a4d8cf6c69c8278149bd838aa5e51814a4ebeff6935733a407
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.6 {"installer":{"name":"uv","version":"0.13.6","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.10.4-py3-none-any.whl

Download URL stackops-26.10.4-py3-none-any.whl
Size 2.2 MB
Tags Python 3
SHA-256 checksum
How to use checksums
fcf1fa9eea2d8200fe5b79c93066bf274601ba3926e9a545ec825e35a84377b2
BLAKE2b-256 checksum
How to use checksums
efe741405c9721b5f2aa6a1b90a0ffcd0e0d461c6b53a87553695260a649f37f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.6 {"installer":{"name":"uv","version":"0.13.6","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.10.4

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