# Install timoni with Homebrew, apk, MacPorts, Nix, zypper, scoop, winget

Package manager for Kubernetes, powered by CUE and inspired by Helm. Version 0.29.0 via Homebrew; verified 2026-08-03. Also installable with nix: nix profile install nixpkgs#timoni.

## Install

```sh
sudo av install brew:timoni
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install timoni
```

  Evidence: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install timoni
```

  Evidence: MacPorts ports tree: sysutils/timoni/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

### Linux

- apk (92%):

```sh
sudo apk add timoni
```

  Evidence: Alpine Linux edge package indexes: timoni from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz

- Nix (92%):

```sh
nix profile install nixpkgs#timoni
```

  Evidence: nixpkgs package indexes: pkgs/by-name/ti/timoni/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

- zypper (92%):

```sh
sudo zypper install timoni
```

  Evidence: openSUSE Tumbleweed package metadata: timoni from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst

### Windows

- Scoop (92%):

```sh
scoop install main/timoni
```

  Evidence: Scoop official bucket manifest trees: bucket/timoni.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1

- winget (92%):

```sh
winget install --id stefanprodan.timoni -e
```

  Evidence: Windows Package Manager source index: stefanprodan.timoni from https://cdn.winget.microsoft.com/cache/source.msix

## Package facts

- **Package key:** brew:timoni
- **Package manager:** Homebrew
- **Version:** 0.29.0
- **Source summary:** Package manager for Kubernetes, powered by CUE and inspired by Helm
- **Homepage:** <https://timoni.sh/>
- **Repository:** <https://github.com/stefanprodan/timoni>
- **Last updated:** 2026-08-03T15:43:31Z
- **Generated:** 2026-08-03T19:37:03+00:00

## Executables

- timoni (alias)

## Install behavior

- Bottle: not available

## Freshness

- Page generated: 2026-08-03
- Package-manager version: 0.29.0
## Project history and usage

Timoni is a Kubernetes package manager built around CUE, OCI artifacts, and Helm-like application lifecycle concepts. Its own documentation presents it as a way to package Kubernetes application definitions as type-safe modules, instantiate them on clusters, and compose larger deployments with bundles.

### Project history

The project was created by Stefan Prodan and describes itself as powered by CUE and inspired by Helm. Its README frames the project as an attempt to improve Kubernetes configuration authoring by replacing Helm-style Go-template YAML and Kustomize-style YAML layering with CUE type checking, code generation, and validation.

Timoni's model deliberately maps familiar Helm concepts into a CUE/OCI vocabulary: modules correspond to charts, instances correspond to releases, and bundles correspond to umbrella charts. That made the project legible to Kubernetes operators while still giving package nerds a newer artifact and schema story to inspect.

### Adoption history

The official docs show Timoni being distributed through Homebrew and used against OCI registries such as GitHub Container Registry. The supplied package-manager facts also show packaging across Homebrew, MacPorts, Nix, Scoop, winget, apk, and zypper, which indicates interest beyond the upstream tap even though the project remains young.

The project has continued regular prerelease-style development, with GitHub showing dozens of releases and v0.27.0 as the latest release on July 2, 2026. Its docs still warn that Timoni is under active development and APIs may change incompatibly, so adoption is best understood as early cloud-native tooling adoption rather than a fully settled ecosystem standard.

### How it is used

Timoni is used from the CLI to apply, build, inspect, upgrade, and delete Kubernetes module instances. The quickstart demonstrates pulling a module from an OCI registry, applying it into a namespace, inspecting module metadata and digest, and later composing multiple instances with a CUE bundle file.

For GitOps users, Timoni can build Kubernetes manifests and push or hand them to Flux workflows. The official Flux interop docs also show Timoni bundles orchestrating Flux HelmRelease resources, giving users a bridge to existing Helm chart repositories.

### Why package nerds care

Timoni matters to package-manager watchers because it treats Kubernetes app packaging as OCI artifacts plus CUE schemas, putting it near Helm, Carvel, Flux OCI, and CUE rather than traditional OS package managers. Its value is in the packaging model: signed, semvered modules distributed next to container images.

It is also a useful example of a modern CLI that appears in many package indexes early in its life, where package availability serves as a signal that platform engineers want repeatable installs even for fast-moving infrastructure tools.

### Timeline

- 2024: Documentation site copyright and examples show Timoni's public docs and quickstart in active use.
- 2026: GitHub lists v0.27.0 as the latest release on July 2, 2026.

### Related projects

- Helm is the most direct conceptual comparison; Timoni explicitly maps modules, bundles, and instances to charts, umbrella charts, and releases.
- CUE supplies the configuration language and type system that differentiates Timoni from YAML-template tools.
- Flux appears in Timoni's official GitOps and Helm-interoperability docs as a companion controller ecosystem.

### Sources

- <https://github.com/stefanprodan/timoni README: project purpose, Helm inspiration, CUE model, module/instance/bundle concepts, active-development warning.>
- <https://timoni.sh/ quickstart and home docs: OCI module workflow, bundle workflow, lifecycle features.>
- <https://timoni.sh/gitops-flux/ and https://timoni.sh/flux-helm-interop/: Flux and Helm interoperability usage.>
- source_facts.package-manager: package availability across multiple package managers.


## Security Notes

infrastructure mutation or orchestration signal.

- **Geiger risk:** orange / medium
- infrastructure mutation or orchestration signal

## Other Package-Manager Records

- Nix - timoni: normalized package name match | nixpkgs package indexes: pkgs/by-name/ti/timoni/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- apk - timoni - 0.23.0-r16: normalized package name match | Alpine Linux edge package indexes: timoni from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz | Package manager for Kubernetes powered by CUE | https://timoni.sh
- apk - timoni-bash-completion - 0.23.0-r16: normalized package name match | Alpine Linux edge package indexes: timoni-bash-completion from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz | Bash completions for timoni | https://timoni.sh
- apk - timoni-doc - 0.23.0-r16: normalized package name match | Alpine Linux edge package indexes: timoni-doc from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz | Package manager for Kubernetes powered by CUE (documentation) | https://timoni.sh
- apk - timoni-fish-completion - 0.23.0-r16: normalized package name match | Alpine Linux edge package indexes: timoni-fish-completion from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz | Fish completions for timoni | https://timoni.sh
- apk - timoni-zsh-completion - 0.23.0-r16: normalized package name match | Alpine Linux edge package indexes: timoni-zsh-completion from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz | Zsh completions for timoni | https://timoni.sh
- zypper - timoni - 0.27.1-1.2: normalized package name match | openSUSE Tumbleweed package metadata: timoni from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst | Package manager for Kubernetes, powered by CUE and inspired by Helm | https://github.com/stefanprodan/timoni
- zypper - timoni-bash-completion - 0.27.1-1.2: normalized package name match | openSUSE Tumbleweed package metadata: timoni-bash-completion from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst | Bash Completion for timoni | https://github.com/stefanprodan/timoni
- zypper - timoni-fish-completion - 0.27.1-1.2: normalized package name match | openSUSE Tumbleweed package metadata: timoni-fish-completion from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst | Fish Completion for timoni | https://github.com/stefanprodan/timoni
- zypper - timoni-zsh-completion - 0.27.1-1.2: normalized package name match | openSUSE Tumbleweed package metadata: timoni-zsh-completion from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst | Zsh Completion for timoni | https://github.com/stefanprodan/timoni
- MacPorts - timoni: normalized package name match | MacPorts ports tree: sysutils/timoni/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1
- Scoop - main/timoni: normalized package name match | Scoop official bucket manifest trees: bucket/timoni.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1
- winget - stefanprodan.timoni: normalized package name match | Windows Package Manager source index: stefanprodan.timoni from https://cdn.winget.microsoft.com/cache/source.msix


## Combined YAML source

View the package source record on GitHub. [combined/timoni.yml](https://github.com/mxcl/pkgdb/blob/main/combined/timoni.yml)


## Sources

- pkg.so package database
- Geiger risk classifier
- curated package history
- pkgdb category and tag curation
- external package-manager database matches
- cross-ecosystem install command graph
