Alle opdrachten (CLI)
Overzicht van elke Switchboard-opdracht voor de terminal, met voorbeelden.
De Switchboard-opdrachten (de CLI, command line interface) gebruik je in de terminal. Meestal voert je AI ze voor je uit, maar je kunt ze ook zelf gebruiken.
Je hoeft niets te installeren. Elke opdracht begint met npx -y @switchboard-host/cli@latest, gevolgd door wat je wilt doen:
npx -y @switchboard-host/cli@latest statusBehalve bij login, init en apps werken de opdrachten met de website van de map waarin je
staat. Met --app naam kies je een andere website.
#Aan de slag
| Opdracht | Wat het doet |
|---|---|
login |
Inloggen via je browser (je keurt de koppeling goed op een pagina van Switchboard). |
logout |
Uitloggen op deze computer. |
whoami |
Laat zien met welk account je bent ingelogd. |
apps |
Je websites. |
init <naam> [map] |
Haalt een website naar deze computer en zet alles klaar: inloggen, bestanden ophalen, onderdelen installeren. |
link [naam] |
Koppelt de map waarin je staat aan een website (als je de bestanden al hebt). |
npx -y @switchboard-host/cli@latest init bakkerij-jansen
npx -y @switchboard-host/cli@latest init bakkerij-jansen website-bakkerij#Online zetten
| Opdracht | Wat het doet |
|---|---|
deploy |
Slaat je wijzigingen op en zet ze online. Volgt het bouwen en geeft het adres of een uitleg bij een fout. |
deploy -m "tekst" |
Hetzelfde, met een beschrijving van wat je hebt veranderd. |
deploy --no-follow |
Start het online zetten zonder te wachten op het resultaat. |
status |
Hoe het met je website gaat. |
logs |
Wat je website nu in het logboek schrijft. -f blijft meekijken; --role backend toont alleen de aparte backend. |
rollback [nummer] |
Zet een eerdere versie terug online (zonder nummer: de vorige). |
restart |
Start je website opnieuw op, bijvoorbeeld na het wijzigen van een instelling. |
open |
Opent je website in de browser. Met --dashboard open je het dashboard. |
npx -y @switchboard-host/cli@latest deploy -m "Prijzen bijgewerkt"
npx -y @switchboard-host/cli@latest logs -f
npx -y @switchboard-host/cli@latest rollback 12#Instellingen
| Opdracht | Wat het doet |
|---|---|
env list |
Je instellingen en geheimen (geheimen zie je niet). |
env set NAAM WAARDE |
Slaat een instelling op. Met --secret wordt het een geheim. Zonder waarde vraagt hij erom. |
env unset NAAM |
Verwijdert een instelling. |
domains |
Je domeinnamen en of ze al werken. |
npx -y @switchboard-host/cli@latest env set CONTACT_EMAIL info@bakkerijjansen.nl
npx -y @switchboard-host/cli@latest env set MOLLIE_API_KEY --secretZie ook instellingen en geheimen.
#Hulp
| Opdracht | Wat het doet |
|---|---|
doctor |
Controleert of alles klaarstaat: Node.js, Git, inloggen en de koppeling. Met --fix lost hij wat hij kan zelf op. |
mcp |
Start de MCP-koppeling voor je AI-hulpje. Zie MCP. |
git-credential |
Wordt door Git gebruikt om in te loggen. Niet zelf gebruiken. |
--help |
Laat alle opdrachten zien. |
npx -y @switchboard-host/cli@latest doctor#Opties voor elke opdracht
| Optie | Betekenis |
|---|---|
--app <naam> |
Kies de website (standaard: die van deze map). |
--lang nl of --lang en |
Taal van de meldingen. |
--json |
Antwoord voor programma's en AI-hulpjes. |
--verbose |
Meer details, bij deploy het hele bouwlogboek. |
#Voor gevorderden
- De inloggegevens staan in een bestand op je computer: op Windows in
%APPDATA%\switchboard\config.json, op een Mac in~/Library/Application Support/switchboard/config.jsonen op Linux in~/.config/switchboard/config.json. - In elke websitemap staat
.switchboard/app.jsonmet de naam van de website. Daar staan geen geheimen in. SWITCHBOARD_TOKENenSWITCHBOARD_API_URLoverschrijven de inloggegevens, bijvoorbeeld voor automatisering.- Afsluitcodes:
0gelukt,1fout,2online zetten mislukt.