# flant/shell-operator

Shell-operator is a tool for running event-driven scripts in a Kubernetes cluster

Repository: https://github.com/flant/shell-operator
Canonical: https://ross.abutalabs.com/products/shell-operator
Homepage: https://flant.github.io/shell-operator/
Language: Go
License: Apache-2.0
License Family: permissive
Topics: kubernetes, kubernetes-operator, devops, bash, python, shell-scripting
Last push: 2026-08-21T10:58:06+00:00

## Health v2 (maintenance only)
Score: 98/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 98, release rhythm 98, longevity 100
- inputs: {"age_days": 2721, "days_push": 12, "days_rel": 13, "gap_med": 6, "n_releases_24m": 56}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2605, forks 252 (observed 2026-08-28T04:07:04.003812+00:00)

## What it is
Shell-operator is a tool for running event-driven scripts in a Kubernetes cluster, treating shell scripts as hooks triggered by Kubernetes object events. It acts like an operator-sdk for scripts, letting Ops use bash, python, or kubectl to react to cluster events.

## Use cases
- run bash scripts when kubernetes objects change
- create a kubernetes operator without writing go
- trigger scripts on pod or configmap events
- build validating webhooks with shell scripts
- automate cluster tasks with familiar shell tooling
- monitor kubernetes resources and react to changes

## When to choose
- you want event-driven automation in kubernetes using bash or python instead of go
- you need a lightweight alternative to writing a full operator with operator-sdk
- your team is ops-focused and prefers shell scripting for cluster management

## When to avoid
- you need a full-featured operator with helm chart management and value storage (use addon-operator instead)
- you require complex reconciliation logic better suited to a compiled language
- you are not running in a kubernetes environment

## Facets
- artifact type: framework
- maturity: stable
- function: workflow-automation, webhook, middleware
- domain: -
- platform: go
- tags: kubernetes-operator, shell-scripts, event-driven, bash, operator-sdk, hooks, kubernetes, devops, automation, containers, docker, linux

## Member repositories
- flant/shell-operator (main) score 98

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:07:04.003812+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:21:02.585601+00:00, confidence not recorded.
  - readme: https://github.com/flant/shell-operator (fetched 2026-08-28T04:07:04.003812+00:00, sha 72fe715bf1ac)
  - homepage: https://flant.github.io/shell-operator/ (fetched 2026-08-29T10:03:56.763650+00:00, sha a5d7a26c9f7a)
- Data as of 2026-08-30T08:39:29.467469+00:00.