Uninstall

How to cleanly remove Tiny Systems components from your system and cluster.

MCP Server

Homebrew

brew uninstall tiny-systems/tap/mcp-server

Go install

Delete the binary from your $GOPATH/bin:

rm $(which mcp-server)

Claude Code

Remove the MCP server registration:

claude mcp remove tinysystems-local

Or edit ~/.claude.json and delete the tinysystems-local entry from mcpServers.

Claude Desktop

Remove the tinysystems entry from ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or the equivalent config on your OS.

Kubernetes Components

Remove all flows and nodes from a namespace

This deletes every Tiny Systems workflow in the namespace. Irreversible.

kubectl delete tinynodes --all -n <namespace>
kubectl delete tinyflows --all -n <namespace>
kubectl delete tinyprojects --all -n <namespace>
kubectl delete tinyscenarios --all -n <namespace>
kubectl delete tinysignals --all -n <namespace>

Uninstall modules

List installed Helm releases to find module names:

helm list -n <namespace> | grep tinysystems

Then uninstall each one:

helm uninstall <release-name> -n <namespace>

For example:

helm uninstall common-module -n tinysystems
helm uninstall http-module -n tinysystems
helm uninstall communication-module -n tinysystems

Remove the otel-collector

helm uninstall tinysystems-otel-collector -n <namespace>

Remove CRDs

WARNING

This deletes ALL Tiny Systems resources across ALL namespaces in the cluster. Only do this if you are fully removing Tiny Systems.

helm uninstall tinysystems-crd -n <namespace>

Or manually:

kubectl delete crd tinynodes.operator.tinysystems.io
kubectl delete crd tinyflows.operator.tinysystems.io
kubectl delete crd tinyprojects.operator.tinysystems.io
kubectl delete crd tinymodules.operator.tinysystems.io
kubectl delete crd tinyscenarios.operator.tinysystems.io
kubectl delete crd tinysignals.operator.tinysystems.io

Remove the namespace

If you created a dedicated namespace:

kubectl delete namespace tinysystems

Desktop Client

macOS

Move Tiny Systems.app from /Applications to Trash.

Windows

Uninstall via Settings → Apps → Tiny Systems.

Linux

Remove the AppImage / .deb / .rpm package you installed.