Skip to content

Quickstart

Choose a workflow

After installation, inspect the command families and the workflow you need:

stackops --help
devops software install --help
devops config dotfiles sync --help
terminal run --help

Install tools

For example, check whether Television's tv binary is available:

devops software install tv --check

This checks binary status; it does not preview or validate the installer. To install Television using the packaged catalog:

devops software install tv --source library

Availability and installer behavior depend on the platform. To select other tools interactively:

devops software install --interactive --source library

If you already know the bundle you want:

devops software install --group <group-name>

Check the live help and package guide before choosing names:

devops software install --help

Choose configuration changes

Configuration sync uses declared mappings. Inspect its options and the configuration guide before choosing a mapping:

devops config dotfiles sync --help
devops data sync --help

devops config interactive offers package, asset, configuration, and shell setup choices. Its copy and symlink choices select library or user mappings and use overwrite-default-path, which can replace existing target files. The explicit scripted example below uses throw-error to stop on conflicts.

Optional workstation setup

This broader sequence installs system and terminal package groups, copies bundled assets, applies the library configuration mappings, and updates the default shell profile. It is useful when you want StackOps' workstation conventions. On an existing configured machine, choose only the individual actions you need. System package groups can invoke privileged package managers, and their behavior varies by platform.

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 sync command copies files; it does not create symlinks. If it reports a conflict, inspect the existing target and choose a conflict policy deliberately. Open a new shell after configuring its profile.

Explore the rest of the CLI

devops --help
cloud --help
terminal --help
agents --help
utils --help
fire --help
preview --help
seek --help
stackops --help

Next steps

  • User Guide


    Continue to the broader documentation.

    User Guide

  • CLI Reference


    Browse the full command reference.

    CLI Reference