CLI Reference¶

Usage¶

sikifanso [global flags] <command> [command flags]

Global flags¶

The --cluster flag can also be set via the SIKIFANSO_CLUSTER environment variable.

cluster -- Manage local Kubernetes clusters¶

cluster create¶

Create a new k3d cluster with Cilium and ArgoCD pre-configured.

sikifanso cluster create
sikifanso cluster create --name mylab
sikifanso cluster create --profile agent-dev
sikifanso cluster create --name mylab --profile agent-dev,rag

If flags are omitted, the CLI prompts interactively. For release builds using the default bootstrap repo, the CLI automatically pins to the matching bootstrap tag. Dev builds and custom bootstrap repos default to HEAD.

See Profiles for available profiles and composition.

cluster delete [NAME]¶

Delete a cluster and clean up all resources.

sikifanso cluster delete
sikifanso cluster delete mylab

cluster info [NAME]¶

Show cluster details, credentials, and runtime health. Omit the name to list all clusters.

sikifanso cluster info
sikifanso cluster info mylab

cluster start [NAME]¶

Start a previously stopped cluster.

sikifanso cluster start
sikifanso cluster start mylab

cluster stop [NAME]¶

Stop a running cluster without deleting it. State is preserved.

sikifanso cluster stop
sikifanso cluster stop mylab

cluster doctor¶

Run health checks on the cluster and its components. Exits 0 when all checks pass, 1 when any check fails.

sikifanso cluster doctor
sikifanso cluster doctor --cluster mylab

Checks run in order:

Each failure includes a cause and a suggested fix command:

ok  Docker daemon       running (v27.0.3)
ok  k3d cluster         1/1 nodes ready
ok  Cilium              DaemonSet 1/1 ready
ok  Hubble              relay deployment ready
ok  ArgoCD              3/3 deployments ready
!!  App: grafana         Degraded -- Synced
                         -> Deployment grafana in namespace monitoring: replicas unavailable
                         -> Try: sikifanso app disable grafana

If no cluster session exists, doctor runs the Docker check only and reports the missing cluster with a suggested sikifanso cluster create fix.

cluster dashboard¶

Start the local web dashboard. Opens a browser automatically unless --no-browser is set. Press Ctrl+C to stop.

sikifanso cluster dashboard
sikifanso cluster dashboard --addr :8080
sikifanso cluster dashboard --no-browser

cluster upgrade¶

Upgrade cluster components (Cilium and ArgoCD). Takes a pre-upgrade snapshot by default. Without --all, shows subcommand help.

sikifanso cluster upgrade --all
sikifanso cluster upgrade --all --skip-snapshot
sikifanso cluster upgrade cilium
sikifanso cluster upgrade argocd

cluster upgrade cilium¶

Upgrade Cilium CNI only.

cluster upgrade argocd¶

Upgrade ArgoCD only.

cluster profiles¶

List available cluster profiles for the --profile flag. Shows each profile's name, description, and included apps.

sikifanso cluster profiles

app -- Manage applications¶

Unified management for both catalog apps and custom Helm charts.

app add [NAME]¶

Add a custom Helm chart to the gitops repo. Writes a coordinate file and a stub values file, auto-commits, and triggers an ArgoCD sync. For curated apps, use app enable instead.

sikifanso app add podinfo --repo https://stefanprodan.github.io/podinfo --chart podinfo --version 6.10.1 --namespace podinfo
sikifanso app add   # interactive — see below

Interactive mode has two paths:

• No args, no flags, TTY -- launches a TUI catalog browser where you can toggle catalog apps on/off with a single keypress
• Name given but flags missing -- prompts for each missing field individually

Creates two files in the gitops repo:

• apps/coordinates/<name>.yaml -- Helm chart coordinates
• apps/values/<name>.yaml -- stub values file

app list¶

List all installed apps in the current cluster's gitops repo. Shows both custom apps and enabled catalog apps, with a SOURCE column to distinguish them.

sikifanso app list
sikifanso app list --all

NAME                 CHART                  VERSION    NAMESPACE    SOURCE
litellm-proxy        litellm                0.2.1      gateway      catalog
langfuse             langfuse               1.2.14     observability catalog
podinfo              podinfo                6.10.1     podinfo      custom

app remove NAME¶

Remove a custom app from the gitops repo. Deletes the coordinate and values files, auto-commits, and triggers an ArgoCD sync. To disable a catalog app, use app disable instead.

sikifanso app remove podinfo

Shell completion is supported -- press Tab to see available app names.

app enable NAME¶

Enable a catalog application. Sets enabled: true in the catalog entry, commits, and triggers an ArgoCD sync.

sikifanso app enable litellm-proxy

If the app is already enabled, prints a message and does nothing. Shell completion suggests disabled catalog app names.

app disable NAME¶

Disable a catalog application. Sets enabled: false in the catalog entry, commits, and triggers an ArgoCD sync.

sikifanso app disable litellm-proxy

If the app is already disabled, prints a message and does nothing. Shell completion suggests enabled catalog app names.

app sync¶

Trigger ArgoCD sync for all or specific applications. Bypasses the default 3-minute polling interval.

sikifanso app sync
sikifanso app sync --app podinfo
sikifanso app sync --no-wait

When --app is set, only that application is synced. By default, the command waits for all applications to reach Synced/Healthy or timeout.

app status [APP]¶

Show detailed application status with resource tree. Omit the app name to show all apps.

sikifanso app status
sikifanso app status litellm-proxy

app diff APP¶

Show diff between live and desired state for an application.

sikifanso app diff litellm-proxy

app logs APP¶

Stream pod logs for an application.

sikifanso app logs litellm-proxy --pod litellm-proxy-0
sikifanso app logs litellm-proxy --pod litellm-proxy-0 --follow

app rollback APP¶

Roll back an application to a previous revision.

sikifanso app rollback litellm-proxy
sikifanso app rollback litellm-proxy --revision 3

agent -- Manage isolated agent namespaces¶

See Agent Sandboxes for a full guide.

agent create NAME¶

Create an isolated agent namespace with resource quotas and network policies.

sikifanso agent create my-agent
sikifanso agent create my-agent --cpu 1 --memory 1Gi --pods 20

agent list¶

List all agent namespaces with their resource quotas.

sikifanso agent list

agent delete NAME¶

Delete an agent namespace and clean up all resources.

sikifanso agent delete my-agent

snapshot -- Capture, restore, and manage cluster snapshots¶

snapshot capture¶

Capture the cluster's configuration state (session metadata + gitops repo) into a .tar.gz archive stored at ~/.sikifanso/snapshots/.

sikifanso snapshot capture --name before-upgrade

snapshot list¶

List all available snapshots. Shows name, cluster, creation time, and CLI version.

sikifanso snapshot list

snapshot restore NAME¶

Restore a cluster's configuration from a snapshot. This restores the session metadata and gitops repo only -- you must run sikifanso cluster create afterward to recreate the cluster infrastructure.

sikifanso snapshot restore before-upgrade

Shell completion is supported.

snapshot delete NAME¶

Delete a snapshot archive.

sikifanso snapshot delete old-snapshot

Shell completion is supported.

mcp serve¶

Start the MCP (Model Context Protocol) server on stdio transport. See MCP Server for setup and tool catalog.

sikifanso mcp serve

Environment variables¶