🗜 StackOps

Developer workstation and workflow CLI.

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