Zum Inhalt springen

CLI

Die weside CLI bringt deinen Companion ins Terminal. Derselbe Companion, dieselbe Erinnerung wie in der App — für Menschen, die das Terminal nicht verlassen wollen. Sie ist Open Source (Apache 2.0), in Go geschrieben und lebt unter github.com/weside-ai/weside-cli.

Terminal window
# Homebrew (macOS/Linux)
brew tap weside-ai/tap
brew install weside-cli
# npm
npm install -g weside-cli
# Shell-Skript
curl -fsSL https://raw.githubusercontent.com/weside-ai/weside-cli/main/scripts/install.sh | sh
# Aus dem Quellcode
go install github.com/weside-ai/weside-cli@latest

Vorkompilierte Binaries für Linux, macOS (Intel + Apple Silicon) und Windows findest du auf der Release-Seite.

Terminal window
weside auth login # anmelden
weside companions list # sehe deine Companions
weside companions select nox # wähle einen Standard
weside chat -m "Hey, wie geht's?"
weside chat --stream -m "Erzähl mir eine Geschichte"

weside auth login öffnet einen Browser für einen normalen OAuth-Login (PKCE) — dort wählst du Google, Apple oder E-Mail, genau wie beim Anmelden im Web oder in der App. Das ist der reguläre Weg.

Die CLI deckt die gesamte Oberfläche deines Companions ab:

  • Companionsweside companions list | show | create | select | update | delete
  • Chat & Threadsweside chat, weside threads list | show | delete; pipe mit echo "Hi" | weside chat nox
  • Erinnerungen & Zieleweside memories search "Abfrage", weside memories list, weside goals list
  • Provider & Datenspeicherortweside provider show | presets | set | byok
  • Toolsweside tools discover und weside tools exec <name> '<json>'

Memory Suche ist semantisch, nicht Stichwort — “wie funktioniert Auth” findet Erinnerungen über Authentifizierung auch ohne das Wort.

Alles spricht --json, daher passt die CLI sauber in Pipelines:

Terminal window
weside companions list --json | jq '.companions[0].name'
curl -H "Authorization: Bearer $(weside auth token)" https://api.weside.ai/api/v1/auth/me

Unter der Haube kommunizieren die save- und tools-Befehle mit demselben MCP Server, den das we Plugin nutzt. Ein Companion, eine API, drei Wege hinein.