Skip to main content

🗜 StackOps

Developer workstation and workflow CLI.

Docs PyPI package Python 3.13+ Installed with uv

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.

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 install --help
devops config 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 install --group sysabc
devops config copy-assets all
devops config sync down \
  --sensitivity public \
  --method copy \
  --on-conflict throw-error \
  --which all
devops config terminal config-shell --which default
devops 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.9.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.9.3
File Size Uploaded
stackops-26.9.3.tar.gz 1.4 MB Details

Built distribution (wheel)

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

Total release size: 3.3 MB

Release files / stackops-26.9.3.tar.gz

Download URL stackops-26.9.3.tar.gz
Size 1.4 MB
Tags Source
SHA-256 checksum
How to use checksums
960cc6f05fddf2eb0dc37e959033006d33869093da4154943f7e7c8bdcc26e7a
BLAKE2b-256 checksum
How to use checksums
4f1ba872dcd220d4bce1cfc490694eee52d569fcf166df881577e5c5b2156f8f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.12.16 {"installer":{"name":"uv","version":"0.12.16","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.9.3-py3-none-any.whl

Download URL stackops-26.9.3-py3-none-any.whl
Size 1.9 MB
Tags Python 3
SHA-256 checksum
How to use checksums
973404acaba8a79d259c19426c442ee0b13b9794b8c7126f432fcb2d60f2f003
BLAKE2b-256 checksum
How to use checksums
548653be195e4a74fc35010ed6e6d4af9f4a3293a90bc9e3ad5bcbef8ea72ccc
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.12.16 {"installer":{"name":"uv","version":"0.12.16","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 history Release notifications | RSS feed

26.9.4

2 release files

This release

26.9.3 This release

2 release files

26.9.2

2 release files

26.9.1

2 release files

26.9

2 release files

26.8.2

2 release files

26.8.1

2 release files

26.8

2 release files

26.7

2 release files

26.6.7

2 release files

26.6.6

2 release files

26.6.5

2 release files

26.6.4

2 release files

26.6.3

2 release files

26.6.2

2 release files

26.6

2 release files

8.104

2 release files

8.103

2 release files

8.102

2 release files

8.101

2 release files

8.100

2 release files

8.99

2 release files

8.98

2 release files

8.97

2 release files

8.96

2 release files

8.95

2 release files

8.93

2 release files

0.1.0

2 release files

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