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

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

Built distribution (wheel)

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

Total release size: 6.7 MB

Release files / stackops-26.11.8.tar.gz

Download URL stackops-26.11.8.tar.gz
Size 4.3 MB
Tags Source
SHA-256 checksum
How to use checksums
3af5ef2f013c6794e71936b1d6d24e82e8dbe6fc18261fc097fae66a2ddc7eb0
BLAKE2b-256 checksum
How to use checksums
5f14f3d91508193e2fbb7e70e6314fd62676331ecdf00eacf087b7808cc50ab9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.8 {"installer":{"name":"uv","version":"0.13.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","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.8-py3-none-any.whl

Download URL stackops-26.11.8-py3-none-any.whl
Size 2.4 MB
Tags Python 3
SHA-256 checksum
How to use checksums
17abc045b16aa25244ab6671d380089fbdb8f85309ece21f17ed5b2b88e21682
BLAKE2b-256 checksum
How to use checksums
102c2f7a3fdc6929be3fb82a8c1f4021fac1021d4b7ace36a031961d40cac0f1
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.8 {"installer":{"name":"uv","version":"0.13.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","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.8

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