Skip to content

devops

devops is the main operational CLI for package installation, repo automation, config sync, data sync, self-management, networking, script execution, and vault access.

Usage

devops [OPTIONS] COMMAND [ARGS]...

Current top-level commands

Command Purpose
install Install packages or named groups
repos Manage development repositories
config Configuration and dotfile workflows
data Backup and restore configured data paths
self StackOps self-management and developer workflows
network Sharing, transfer, address, SSH, and device helpers
execute Run scripts from predefined locations or as a raw command
vault Search Bitwarden credentials and manage login/unlock state

install

devops install [OPTIONS] [WHICH]

Current options:

  • --group to treat WHICH as a bundle name
  • --interactive to choose packages interactively
  • --explore / -x to browse installer categoryLabels before choosing packages
  • --update to reinstall or upgrade when supported
  • --version to request a specific version or tag

Example:

devops install --group sysabc
devops install --explore
devops install ai-agents-assistants -x
devops install lazygit,fd --update

Current command groups

These are the child commands exposed by the current live help.

repos:

  • sync
  • register
  • action
  • analyze
  • guard
  • viz
  • count-lines
  • config-linters
  • cleanup

config:

  • interactive
  • sync
  • register
  • edit
  • export-dotfiles
  • import-dotfiles
  • copy-assets
  • dump
  • terminal
  • secrets

data:

  • sync
  • register
  • edit

self:

  • install
  • clone
  • update
  • status
  • security
  • explore
  • readme
  • docs
  • build-installer
  • download-installer
  • build-docker
  • build-graph
  • build-assets
  • agentops

network:

  • share-terminal
  • share-server
  • send
  • receive
  • share-temp-file
  • show-address
  • vscode-share
  • ssh
  • device

vault:

  • search
  • login-and-unlock
  • clean-cache

execute

devops execute [OPTIONS] [NAME]

Current behavior:

  • NAME can be a predefined script name or a raw command string
  • when NAME is a direct script file path, execute runs it without searching the configured script roots
  • --source, -s selects search locations: all, repo, private, public, library, or dynamic
  • --source repo or -s repo searches <git-root>/.stackops/scripts
  • --interactive enables interactive selection
  • --command runs the input as a command
  • --list prints the available scripts

Examples:

devops execute --list
devops execute deploy -s library
devops execute "echo hello" --command

vault

devops vault COMMAND [ARGS]...

Current behavior:

  • search retrieves Bitwarden credentials and can copy password, username, TOTP, or raw JSON to clipboard slots
  • login-and-unlock loads Bitwarden API credentials from StackOps secrets, unlocks the vault, and saves BW_SESSION locally
  • clean-cache removes cached search results and any saved session token

Examples:

devops vault login-and-unlock --account-name dev
devops vault search github --copy password
devops v s github --json
devops vault clean-cache

Working with nested apps

The nested groups above are lazily loaded Typer apps. The exact leaf commands and flags live under those subtrees, so use help at the branch you care about:

devops repos --help
devops config --help
devops data --help
devops self --help
devops network --help
devops vault --help
devops self docs --help
devops config terminal --help