Famulor CLIFür Terminal, Skripte und Coding-Agents

Famulor im Terminal.
Jede API-Operation ein Befehl.

Leg Assistenten an, starte Anrufe, pflege Kampagnen und Leads: mit einem Befehl, in Skripten oder aus deinem Coding-Agent. Dein API-Key liegt im OS-Schlüsselbund.

API-Key holenDoku lesen
npm install -g famulor
  • Jede API-Operation
  • JSON, Tabelle, JSONL
  • Key im OS-Schlüsselbund
Beispiel
$ npm install -g famulor
$ famulor
Famulor CLI
Voice AI agents, straight from your terminal.
$ famulor login
◆  Paste your API key (input hidden):
✓ Logged in
Workspace  Bright Smile Dental
Host  app.famulor.io
Stored in  OS keychain
$ famulor assistants create --name "Front Desk"
✓ Create an assistant · 1153 ms
{
  "data": {
    "id": "3e8b1f6a-9c2d-4a7e-b1f5-6d7c8e9a0b55",
    "name": "Front Desk",
    "is_active": true,
    "mode": "pipeline",
    "language": "en",
    "created_at": "2026-10-01T09:41:00Z"
  }
}

Die Famulor CLI in Aktion

Beim Abspielen wird YouTube geladen. Datenschutz

Befehle

Jede API-Operation ist ein Befehl.

Die Befehle entstehen direkt aus der OpenAPI-Spezifikation. Tippe den Namen der Operation oder Bereich plus Verb.

Assistenten

assistants
famulor assistants create --name "Front Desk"
famulor update-assistant <id> --llm-temperature 0.4

Anrufe

calls
famulor create-call --assistant-id <id> --to-number +4930123456
famulor get-call-recording <call-id> --output-file call.ogg

Kampagnen und Leads

campaigns
famulor add-leads <campaign-id> --phone +4930123456 --name "Mia"
famulor start-campaign <campaign-id>

Rufnummern

phone-numbers
famulor search-available-phone-numbers --country DE
famulor list-phone-numbers --output table

Wissensbasen

knowledge-bases
famulor create-knowledge-base --name "FAQ"
famulor add-knowledge-document <id> --url https://example.com/faq

Alles andere

famulor api
famulor commands recording
famulor api GET /assistants --query limit=5

Jeder Bereich listet seine Befehle: famulor <area>

  • assistants
  • calls
  • campaigns
  • leads
  • phone-numbers
  • voices
  • knowledge-bases
  • tools
  • automations
  • bookings
  • messaging
  • sms
  • history
  • integrations
  • widgets
  • translation
  • loop
  • milian
  • qa
  • dashboards
  • segments
  • callbacks
  • suppression
  • caller-ids
  • sip-trunks
  • carrier-connections
  • white-label
  • workspaces
  • api-keys
  • billing
  • settings
  • account
  • catalog
  • migrations
Ausgabe

Lesbar für dich. Parsebar für Skripte.

Dieselbe Antwort, drei Formate. Mit --all holt die CLI jede Seite einer Liste.

zsh
famulor list-calls --limit 2 --output table
ID STATUS TO NUMBER DURATION SEC ────────────────────────────────────────────────────────────────────────────── c3a91f-4d2e-4b7a-9c1f-0a1b2c3d4e10 ● completed +1 415 555 0120 142 c3c80e-4d2e-4b7a-9c1f-0a1b2c3d4e11 ● completed +1 415 555 0123 96 2 of 212 · add --all to fetch every page
Für Coding-Agents

Dein Coding-Agent kennt jeden Befehl.

Agents lesen jedes Befehlsschema als JSON und bekommen Fehler maschinenlesbar zurück. Farben, Animation und Rückfragen schalten sich dort von selbst ab.

Befehle finden

famulor commands recording

Schema lesen

famulor create-call --help --output json

Fehler als JSON

{"error":{"code","message","status","exit_code"}}

Läuft in jedem Agent, der Befehle ausführt

  • Claude Code
  • Codex
  • Cursor
  • Gemini CLI
  • Windsurf
  • Warp
  • OpenClaw
  • Hermes
Agent

Du: Ruf mit Front Desk die +49 30 123456 an.

Bash
famulor commands call
Bash
famulor create-call --help --output json
Bash
famulor create-call --assistant-id 3e8b1f6a-9c2d-4a7e-b1f5-6d7c8e9a0b55 --to-number +4930123456

Agent: Erledigt. Der Anruf ist gestartet, Status: queued.

Sicher ab Werk

Nichts passiert aus Versehen.

Rückfrage vor jedem Löschen, eine Vorschau für jede Anfrage und ein Key, der nie im Klartext liegt.

Erst fragen, dann löschen

Löschen und endgültige Aktionen wie ein Nummernkauf fragen vorher nach. In Skripten bestätigst du mit --yes.

Vorschau mit --dry-run

Du siehst Methode, URL, Header und Body. Der Key ist geschwärzt, gesendet wird nichts.

Kein doppelter Anruf

Anfragen, die etwas anlegen, werden nach einem Timeout nie wiederholt. Rate Limits wartet die CLI selbst ab.

Key im Schlüsselbund

Der Key wird vor dem Speichern geprüft. Dann liegt er im Schlüsselbund von macOS, Windows oder Linux.

Ein Profil pro Workspace

Speichere Logins pro Workspace und wechsle mit famulor auth switch. In CI reicht FAMULOR_API_KEY.

Auch auf deiner Domain

White-Label-Partner melden sich einmal mit --base-url an. Das Profil merkt sich den Host.

zsh
famulor delete-assistant 3e8b1f6a-9c2d-4a7e-b1f5-6d7c8e9a0b55
! Delete an assistant "Front Desk" (3e8b1f6a-9c2d-4a7e-b1f5-6d7c8e9a0b55) in Bright Smile Dental on app.famulor.io? This cannot be undone. [y/N] n
✗ Cancelled. Nothing was deleted.
famulor create-call --assistant-id 3e8b1f6a-9c2d-4a7e-b1f5-6d7c8e9a0b55 --to-number +4930123456 --dry-run
{ "command": "create-call", "operation_id": "createCall", "method": "POST", "url": "https://app.famulor.io/api/v1/calls", "headers": { "Authorization": "Bearer fam_[REDACTED]", "Content-Type": "application/json" }, "body": { "assistant_id": "3e8b1f6a-9c2d-4a7e-b1f5-6d7c8e9a0b55", "to_number": "+4930123456" } }
CLI, MCP oder API

Drei Wege zu Famulor. Nimm den passenden.

Alle drei arbeiten mit demselben Workspace und denselben Daten.

Diese Seite

Famulor CLI

Für Terminal, Skripte, CI und Coding-Agents.

  • Ein Befehl pro API-Operation
  • JSON, Tabelle oder JSONL
  • Key im OS-Schlüsselbund
Doku lesen

MCP Connector

Für Claude, ChatGPT und andere KI-Tools im Chat.

  • Eine Server-URL, Login per OAuth
  • Famulor-Tools direkt im Chat
  • Keine lokale Installation
Zum MCP Connector

REST API

Für dein eigenes Produkt und Backend.

  • OpenAPI-Spezifikation
  • Webhooks in Echtzeit
  • Jede Sprache, jedes Framework
Zur API-Referenz
Alles für Entwickler
Auf einen Blick

Ein Tool für die ganze Plattform.

Befehl je Operation

1:1

Generiert aus der OpenAPI-Spezifikation.

Ausgabeformate

3

JSON, Tabelle und JSON Lines.

Klare Exit-Codes

0–5

Erfolg, API, Aufruf, Login, nicht gefunden, abgebrochen.

Shells mit Completion

3

bash, zsh und fish.

Los geht’s

In drei Befehlen startklar.

Installieren, anmelden, loslegen.

  1. 01

    Installieren

    npm install -g famulor. Läuft auf macOS, Linux und Windows mit Node.js 22 oder neuer.

  2. 02

    Anmelden

    famulor login fragt nach deinem API-Key aus Settings → API & MCP und prüft ihn, bevor er gespeichert wird.

  3. 03

    Loslegen

    famulor --help zeigt alle Bereiche. famulor calls listet zum Beispiel jeden Befehl rund um Anrufe.

Passt dazu

Mehr aus der Plattform

Weitere Bausteine, die Teams meist zusammen mit dieser Funktion nutzen.

FAQ

Fragen vor dem Go-live

Was ist die Famulor CLI?

Die Famulor CLI ist das offizielle Kommandozeilen-Tool für Famulor. Jede öffentliche REST-API-Operation ist ein Befehl: Assistenten, Anrufe, Kampagnen, Leads, Rufnummern, Wissensbasen, Automationen und mehr. Du nutzt sie im Terminal, in Skripten, in CI oder über deinen Coding-Agent.

Was brauche ich, um die CLI zu nutzen?

Node.js 22 oder neuer und einen Workspace-Plan mit API Access. Installiert wird mit npm install -g famulor. Den API-Key erstellst du im Dashboard unter Settings → API & MCP und meldest dich dann mit famulor login an.

Wo wird mein API-Key gespeichert?

famulor login prüft den Key gegen die API, bevor etwas gespeichert wird. Danach liegt er im Schlüsselbund deines Systems: macOS-Schlüsselbund, Windows Credential Manager oder Linux Secret Service. Ohne Schlüsselbund landet er in einer Datei, die nur du lesen kannst. In CI setzt du stattdessen FAMULOR_API_KEY.

Kann ich die CLI mit Claude Code, Codex oder Cursor nutzen?

Ja. famulor commands <thema> liefert passende Befehle als kompaktes JSON, famulor <befehl> --help --output json das vollständige Schema. In Agents und CI schalten sich Farben, Animation und Rückfragen ab. Bei einem Fehler bleibt stdout leer und die letzte Zeile auf stderr ist der Fehler als JSON, mit eindeutigem Exit-Code.

Wann nehme ich die CLI, den MCP Connector oder die API?

Die CLI passt für Terminal, Skripte, CI und Coding-Agents. Der MCP Connector bringt Famulor in Chat-Tools wie Claude oder ChatGPT, ohne lokale Installation. Die REST API nutzt du, wenn du Famulor in dein eigenes Produkt einbaust. Alle drei arbeiten mit demselben Workspace.

Kann ich aus Versehen etwas löschen?

Löschen und endgültige Aktionen wie Nummernkauf, Transfers oder Wiederherstellen fragen im Terminal vorher nach. In Skripten, CI und Coding-Agents laufen sie nur mit --yes. Mit --dry-run siehst du die exakte Anfrage, ohne dass etwas gesendet wird.

Geht das mit mehreren Workspaces und White-Label?

Ja. Ein API-Key gehört zu genau einem Workspace. Speichere pro Workspace ein Profil mit famulor auth login --profile <name> und wechsle mit famulor auth switch. Nutzt du Famulor unter deiner eigenen Domain, meldest du dich einmal mit --base-url an.

Ist die CLI schon stabil?

Die CLI ist eine Public Preview (Version 0.x). Befehlsnamen folgen der API und können sich bis 1.0 noch ändern. Ein umbenannter Befehl funktioniert mindestens eine Minor-Version lang weiter.

Loslegen

Dein Workspace, einen Befehl entfernt.

Hol dir einen API-Key, installiere die CLI und leg mit famulor login los.

API-Key holenDoku lesen

Die Famulor CLI ist kostenlos und MIT-lizenziert. Du brauchst Node.js 22 oder neuer und einen Plan mit API Access.