Automic VaultAutomic Vault

brew

Install litmusctl with Homebrew, Nix

Command-line interface for interacting with LitmusChaos. Version 1.27.0 via Homebrew; verified 2026-07-16. Also installable with nix: nix profile install nixpkgs#litmusctl.

Install commandSecurity notes

install

Additional install commands

macOS

Homebrewverified · 100%
brew install litmusctl

local Homebrew formula metadata

Linux

Nixverified · 92%
nix profile install nixpkgs#litmusctl

nixpkgs package indexes · pkgs/by-name/li/litmusctl/package.nix · source: api.github.com

overview

Package summary

Command-line interface for interacting with LitmusChaos

Commands and aliases

  • litmusctl

history

Project history and usage

litmusctl is the command-line companion to LitmusChaos, a CNCF-hosted cloud-native chaos engineering platform. It matters less as a standalone tool than as the terminal interface for connecting Chaos Delegates, creating projects, scheduling Chaos Scenarios, and managing LitmusChaos accounts.

Project history

LitmusChaos began as Kubernetes-oriented chaos engineering tooling before becoming a CNCF project. The separate litmusctl repository was created on February 15, 2021, after Litmus had already entered CNCF Sandbox, giving operators a Go-based CLI for the agent-plane workflows around Litmus ChaosCenter and Kubernetes clusters.

The litmusctl README documents versioned usage guides spanning early v0.2-era compatibility through later v0.12-v0.23 and 1.x releases, which reflects its role as a compatibility-sensitive operations tool tied to LitmusChaos control-plane versions.

Adoption history

Litmus itself was accepted into CNCF on June 25, 2020 and moved to Incubating on January 11, 2022. That CNCF path gave the surrounding tools, including litmusctl, a place in cloud-native SRE workflows rather than only in vendor-specific chaos demos.

The broader Litmus project advertises adopters and end-user case studies, while litmusctl adoption is mostly implicit: users who run LitmusChaos in Kubernetes clusters need a supported CLI path for delegate connection and account operations.

How it is used

litmusctl is used to connect Chaos Delegates, create projects, schedule Chaos Scenarios, disconnect delegates, and manage multiple LitmusChaos accounts. Its documented requirements include a kubeconfig at ~/.kube/config and kubectl underneath for applying manifests.

For package users, the key operational detail is version compatibility: the README maps litmusctl releases such as 1.19.0 through 1.26.0 to supported Chaos Center version ranges.

Why package nerds care

For Homebrew and Nix users, litmusctl is a small example of a cloud-native project's operational surface being shipped as a standalone CLI, separate from the heavier Kubernetes control plane it manages.

It also shows the package-manager problem of distributing fast-moving Kubernetes ecosystem CLIs whose usefulness depends on a compatibility matrix rather than only on their own version number.

Timeline

  • 2017: LitmusChaos work began as simple Kubernetes chaos jobs, according to CNCF project history.
  • 2020-06-25: Litmus was accepted into CNCF.
  • 2021-02-15: The litmuschaos/litmusctl GitHub repository was created.
  • 2022-01-11: Litmus moved to CNCF Incubating.
  • 2026-05-20: The litmusctl repository listed release 1.26.0.

Related projects

  • LitmusChaos is the parent chaos engineering platform; ChaosHub provides reusable chaos experiments; kubectl and Kubernetes are required context for delegate installation and cluster operations.

security posture

No protected-tool coverage found yet

No matching local secret-handling manifest was found for litmusctl. Nucleus package metadata is still published here so future coverage has a stable package URL.

Install behavior

  • No Homebrew post-install hook is recorded in formula metadata.
  • Homebrew bottle metadata is available for 6 platform targets.
  • Build metadata lists 1 build dependencies.

Recommended review

Before unattended agent use, check whether the tool reads plaintext credentials, writes remote state, publishes artifacts, or shells out to plugins.

local files

Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.

Configuration files

Config paths the tool may read or write during local use.

Unix
~/.kube/config

Credential files

Credential-bearing paths to review before unattended agent runs.

Unix
~/.kube/config

executables

Installed executables

CommandKindExposureNote
litmusctlcliglobal executable

freshness

Version and freshness

These signals separate page generation age, package-manager activity, and upstream release comparison. Version lag is warned only when an evidence URL and comparable versions are present.

page generated2026-07-25
manager version1.27.0
manager updated2026-07-16
local dataok
upstreamcurrent
latest detected1.27.0

https://github.com/litmuschaos/litmusctl

  • okNo freshness warnings were generated.

install metadata

Package metadata

Package keybrew:litmusctl
Version1.27.0
Package managerHomebrew
Package manager pagehttps://formulae.brew.sh/formula/litmusctl
Homepagehttps://litmuschaos.io
Repositoryhttps://github.com/litmuschaos/litmusctl
Upstream docshttps://docs.litmuschaos.io/
LicenseApache-2.0
Source archivehttps://github.com/litmuschaos/litmusctl/archive/refs/tags/1.27.0.tar.gz
Last updated2026-07-16T09:32:18Z
Pulseupdated
Build dependenciesgo
Bottleavailable (on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux)
Homebrew post-installnot defined
Servicenone declared

registry facts

Source database details

Source DatabaseHomebrew formula API
Taphomebrew/core
Full Namelitmusctl
Version Scheme0
Revision0
Head VersionHEAD
Bottle Stable Root URLhttps://ghcr.io/v2/homebrew/core
Deprecatedno
Disabledno
Keg Onlyno
URL Keys
  • head
  • stable

source database matches

Other package-manager records

Matches are pulled from external package-manager indexes and kept separate from local Automic Vault package links.

Nix95%

litmusctl

nix profile install nixpkgs#litmusctl
  • normalized package name match
  • Matched by: Litmusctl
nixpkgs package indexes · api.github.com · nixpkgs package indexes: pkgs/by-name/li/litmusctl/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

package graph

Links come from deterministic package relationships, av.db category and tag curation, ecosystem matches, and package hub membership.

Related tools

  • goBuild dependency declared by Homebrew.

Same workflow

  • chaoskubeShares av.db curated category or tags: chaos-engineering, cli, cloud-infrastructure, kubernetes.
  • openshift-cliShares av.db curated category or tags: cli, cloud-infrastructure, kubernetes.
  • apache-brooklyn-cliShares av.db curated category or tags: cli, cloud-infrastructure.
  • crossplaneShares av.db curated category or tags: cli, cloud-infrastructure, cloud-native, kubernetes.
  • devspaceShares av.db curated category or tags: cli, cloud-infrastructure, cloud-native, kubernetes.
  • egctlShares av.db curated category or tags: cli, cloud-infrastructure, cloud-native, kubernetes.

source trail

Generated from repository data

This page is generated by av-web from the private package SQLite artifact built by scripts/generate-pkg-sqlite.py.

Used sources

  • Geiger risk classifier
  • Nucleus package database
  • av.db category and tag curation
  • cross-ecosystem install command graph
  • curated configuration and credential file locations
  • curated package history
  • external package-manager database matches
  • package relationship graph
  • package version freshness
  • package-page enrichment