Installation¶

Single Binary¶

No runtime dependencies. Pick your install method.

Quick Install (Recommended)¶

Curl Script¶

Detects your OS and architecture, downloads the correct binary, and creates a cs shortcut alias automatically.

curl -fsSL https://cloudslash.dev/install.sh | bash

This installs two commands:

cloudslash: the full binary name
cs: a symlink alias (shorter to type, works everywhere)

Both are identical. All documentation uses cs for brevity.

Alternative Methods¶

Homebrew (Mac/Linux)¶

brew tap DrSkyle/tap
brew install cloudslash

After installing via Homebrew, create the alias manually:

sudo ln -sf $(which cloudslash) /usr/local/bin/cs

Go Install¶

go install github.com/DrSkyle/cloudslash/v2/cmd/cloudslash-cli@latest

The binary is installed as cloudslash-cli. Rename or alias as needed:

mv $(go env GOPATH)/bin/cloudslash-cli $(go env GOPATH)/bin/cloudslash
ln -sf $(go env GOPATH)/bin/cloudslash $(go env GOPATH)/bin/cs

Initialize¶

Run the init wizard to detect cloud credentials, provision the graph store, and configure AI:

cs init

The wizard will:

Run system diagnostics
Scan for AWS, GCP, Azure, and Kubernetes credentials
Provision the BadgerDB graph store and s.a.u state backend
Detect local Ollama for AI (or skip if not running)
Spawn the background daemon
Generate a .cloudslash.yaml Slashfile in your current directory

Use --non-interactive for CI environments or --skip-daemon to skip daemon startup.

# CI-safe: no prompts, no daemon
cs init --non-interactive --skip-daemon

Install Plugins¶

CloudSlash ships as a lightweight core engine. Cloud provider scanners are installed separately. You only install what you need.

# Install the providers you use
cs plugin install aws
cs plugin install gcp
cs plugin install azure
cs plugin install k8s

# See what's available
cs plugin search

# Verify what's installed
cs plugin list

Plugins are pre-compiled binaries: no build tools required. They download to ~/.cloudslash/plugins/ and the daemon auto-discovers them on startup.

Only install what you need

If you only use AWS, just install the AWS plugin. There's no reason to install all providers. You can always add more later.

Configuration¶

After init, configure your AI provider and model:

cs config

This opens an interactive wizard where you pick your provider (Ollama, OpenAI, Anthropic, Gemini, Groq), enter your API key, and select a model from the live list.

The configuration is stored at ~/.cloudslash/config.yaml:

ai:
  provider: gemini
  model: gemini-2.5-pro
  gemini_key: "AIza..."

cloud:
  aws:
    active: true
    profiles: [production, staging]
  gcp:
    active: true
    project: data-lake-prod

daemon:
  scan_interval: 15m
  alert_threshold_usd: 5000

Installation¶

Verifying Your

cs doctor

This runs adaptive diagnostics: checking only what's relevant to your setup.

Uninstall¶

cs uninstall

Removes the graph database, plugins, policies, snapshots, and history. Use --keep-config to preserve your configuration. Use --force to skip confirmation.

# Keep config, remove everything else
cs uninstall --keep-config

# Non-interactive (for scripts)
cs uninstall --force

To also remove the binary itself, follow the instructions printed at the end.