Zum Inhalt springen
weside.aiweside docs

CLI

Die weside CLI bringt deinen Companion ins Terminal. Derselbe Companion, dieselbe Erinnerung wie in der App — für Menschen, die die Kommandozeile lieber nicht verlassen. Sie sitzt auf derselben REST-API und, für zwei Kommandos, auf demselben MCP-Server, den das we Plugin nutzt. Ein Companion, drei Wege hinein.

Was es ist

Abschnitt betitelt „Was es ist“

Eine Open-Source-CLI in Go (Apache 2.0), unter github.com/weside-ai/weside-cli. Sie liefert 38 Kommandos auf oberster Ebene und insgesamt 158 Blattkommandos — diese Seite behandelt die Gruppen, nach denen du greifst. Vollständig und immer aktuell sind weside --help und weside <kommando> --help; sie veralten nicht, wie eine Seite es kann.

Terminal-Fenster
# 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

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

Warum es für dich wichtig ist

Abschnitt betitelt „Warum es für dich wichtig ist“

Alles, was die App tut, tut die CLI auch — Chat, Erinnerung, Ziele, Räume, Sticker, Pläne und Credits, Kontoverwaltung — und sie spricht überall --json. Damit passt sie in Skripte und Pipelines, statt ein einmaliges Terminal-Spielzeug zu bleiben.

Wie du es nutzt

Abschnitt betitelt „Wie du es nutzt“

Einmal anmelden, dann mit deinem Companion sprechen:

Terminal-Fenster
weside auth login                # anmelden
weside companions list           # deine Companions ansehen
weside companions select nox     # einen Standard wählen
weside chat -m "Hey, wie geht es dir?"
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. weside auth login --dev und die Umgebungsvariable WESIDE_TOKEN sind Abkürzungen für Entwicklung und CI auf Maschinen ohne Browser, nicht der alltägliche Weg.

Die Kommandogruppen, nach ihrem Zweck:

  • Companions — companions list | show | create | select | update | delete, dazu Pflege und Einrichtung: companions prompts show | versions | restore, companions identity, companions resume, companions skills available | install | list | set | uninstall, companions tools list | set.
  • Chat & Räume — chat [companion] (-m/--message, -f/--file, --stream, --abort-after), Eingabe über Pipe (echo "Hi" | weside chat nox). Das Chat-Modell in v2 ist raumbasiert, deshalb läuft die Gesprächsverwaltung über rooms list | show | dm | group | rename | delete | participants | mute | unmute | activity | confirmations | events.
  • Erinnerungen & Ziele — memories search "abfrage" | list | get | save | edit | update | delete, goals list | save | update | edit | reorder. Die Suche in der Erinnerung ist semantisch, nicht stichwortbasiert — „wie funktioniert Auth” findet Erinnerungen zur Authentifizierung auch ohne das Wort.
  • Vault: Notizen, Dateien, Ablage — ablage search, files tree | upload | delete | keep | quota, notes list | get | write | delete | search | recent | working-set, stage list | delete, und ein search über den ganzen Vault, das Erinnerungen, Notizen und Dateien zusammen abdeckt.
  • Sticker — stickers workshop slots | generate | reroll | keep | discard | style zum Entwerfen eines Stickers, stickers packs list | show | upload | publish | export, und stickers send.
  • Einladungen & Sicherheit — invite mint | rotate | show | accept für Raumeinladungen, safety block | unblock | blocked | report für Trust-&-Safety-Handlungen.
  • Provider & Datenspeicherort — provider show | presets | set | byok | byok-discover | byok-test | eu-only; siehe den eigenen Modell-Key verbinden.
  • Plan, Credits, Empfehlungen — plans me | show, billing usage | purchase-eligibility, me usage, referrals create | list | revoke | stats.
  • Konto & Datenrechte — me-account export | deactivate | profile | profile-set | locale | sliding-window.
  • Integrationen & der Sandbox-Vault — integrations catalog | list | disconnect | reconcile, sandbox-secrets put | list | delete | presets.
  • Aufmerksamkeit — triggers list | set | toggle | delete, subscriptions list | toggle, reminders list | dismiss, evolution presets | start | current | dismiss, experts list | befriend, mentor-sessions.
  • Kreise & Kanäle — circles create | list | delete, channels list | set-active.
  • Tools — tools discover und tools exec <name> '<json>' für die Aktionen, die dein Companion ausführen kann.
  • Konfiguration und Notausgänge — config show | set | system | refresh-auth, user-config get | set | delete, completion, version, und api <pfad> für einen rohen authentifizierten Aufruf (in --help als (debug) markiert).

Grenzen & Sonderfälle

Abschnitt betitelt „Grenzen & Sonderfälle“
  • api, rooms trace, rooms tool-call und notes-repo repair sind Diagnose-Verben, keine alltäglichen — --help schreibt an api offen (debug). Greif danach bei der Fehlersuche, nicht als erstes Mittel.
  • Nur zwei Verben gehen über MCP. weside memories save und weside tools sprechen mit demselben MCP-Server, den das we Plugin nutzt; alles andere in dieser Liste ist ein direkter REST-Aufruf.
  • Du betreibst ein eigenes Auth-Backend? --supabase-url und --supabase-anon-key sind der Notausgang; ohne sie findet die CLI deinen Auth-Endpunkt über /.well-known/weside-auth. Globale Flags an jedem Kommando: --json, --verbose, --config, --api-url, --no-color, --supabase-url, --supabase-anon-key.
Terminal-Fenster
weside companions list --json | jq '.companions[0].name'
curl -H "Authorization: Bearer $(weside auth token)" https://api.weside.ai/api/v1/auth/me

Nächste Schritte

Abschnitt betitelt „Nächste Schritte“