Parancssor (srvo)

Az srvo terminálból vagy szkriptből futtat SRVO-műveleteket. Ugyanazokat a műveleteket érheted el, mint MCP-n keresztül, azonos jogosultságokkal. A szerepköröd és a kulcsod határozza meg, mit használhatsz.

Telepítés

A CLI korai hozzáférésben van, még nincs közzétéve. A SRVO-tároló másolatából a node packages/cli/src/bin.ts paranccsal futtathatod, Node 24 vagy újabb verzióval. Később letölthető alkalmazás és npm-csomag is lesz.

Bejelentkezés

1. Nyisd meg a Beállítások → API, MCP és webhookok oldalt, és hozz létre egy API-kulcsot. Lásd: API, MCP és webhookok. Ha a szkript csak olvas, válaszd a csak olvasási hozzáférést.
2. Futtasd az srvo login --api-key parancsot, és illeszd be a kulcsot. Gépelés közben nem jelenik meg.

Fájlból is beolvashatod: srvo login --api-key < key.txt. Ne írd a kulcsot közvetlenül a parancssorba. Az srvo ezt elutasítja.

Macen a kulcs a kulcskarikába kerül. Más rendszereken a ~/.config/srvo/credentials.json fájlba, amelyet csak a saját felhasználód olvashat.

Másik szerverhez add meg a --api https://your-server kapcsolót vagy az SRVO_API_URL környezeti változót.

Munkaterületek

Minden kulcs egy munkaterülethez tartozik. Munkaterületenként jelentkezz be.

• Az srvo use acme az acme munkaterületet állítja be alapértelmezettnek.
• A --workspace acme csak az adott parancsra érvényes.
• Az srvo whoami megmutatja a felhasználódat és a munkaterületedet.
• Az srvo logout törli a mentett kulcsot. A használatának letiltásához vond vissza a Beállításokban.

Példák

srvo actions
srvo help boards records create
srvo boards records list --table-id <table id>
srvo boards records list --table-id <table id> --all --json > records.json
srvo boards records create --table-id <table id> --fields '{"title":"Hívd fel Annát"}'
srvo boards records trash --record-id <record id>

A törlő vagy sok adatot módosító műveletek előnézetet mutatnak, és megerősítést kérnek. Szkriptben használd a --yes kapcsolót.

Nagyobb bemenethez használj fájlt: srvo boards records create --table-id <id> --input @record.json.

Használat szkriptekben

• A --json nyers eredményt ír ki, például a jq számára.
• A listák egy oldalt mutatnak. Minden oldalhoz add meg az --all kapcsolót, vagy használd a --cursor kapcsolót.
• Bejelentkezés helyett beállíthatod az SRVO_API_KEY változót, például CI-ben.
• Kilépési kódok: 0 siker, 2 hibás bemenet, 3 nincs bejelentkezés vagy jogosultság, 4 nem található, 5 ütközés, 6 túl sok kérés.

Generált fejlesztői referencia.