Install to your global package directory:
$ npm install -g casualos
Or, execute directly from NPM:
$ npx casualos
Usage: casualos [options] [command]
A CLI for CasualOS
Options:
-V, --version output the version number
-e, --endpoint <url> The endpoint to use for queries. Can be used to override the current endpoint.
-h, --help display help for command
Commands:
login Login to the CasualOS API
logout Logout of the CasualOS API
set-endpoint [endpoint] Set the endpoint that is currently in use.
status Get the status of the current session.
query [options] [procedure] [input] Query the CasualOS API
repl [options] Start a REPL for the CasualOS API
generate-server-config [options] Generate a server config for CasualOS.
validate-server-config [options] Validate a server config for CasualOS.
help [command] display help for command
login$ casualos help login
Usage: casualos login [options]
Login to the CasualOS API
Options:
-h, --help display help for command
logout$ casualos help logout
Usage: casualos logout [options]
Logout of the CasualOS API
Options:
-h, --help display help for command
set-endpoint$ casualos help set-endpoint
Usage: casualos set-endpoint [options] [endpoint]
Set the endpoint that is currently in use.
Arguments:
endpoint The endpoint to use for queries. If omitted, then you will be prompted to enter an endpoint.
Options:
-h, --help display help for command
query$ casualos help query
Usage: casualos query [options] [procedure] [input]
Query the CasualOS API
Arguments:
procedure The procedure to execute. If omitted, then you will be prompted to select a procedure.
input The input to the procedure. If specified, then it will be parsed as JSON. If omitted, then you will be prompted to enter the input.
Options:
-k, --key <key> The session key to use for the query. If not specified, then the current session key will be used.
-h, --help display help for command
repl$ casualos help repl
Usage: casualos repl [options]
Start a REPL for the CasualOS API
Options:
-k, --key <key> The session key to use for the session. If omitted, then the current session key will be used.
-h, --help display help for command
The CasualOS REPL allows you to interact with the CasualOS API using a Read-Eval-Print Loop (REPL).
It supports JavaScript and has a special function, query([procedure], [input]), that can be used to query the API.
generate-server-config$ casualos help generate-server-config
Usage: casualos generate-server-config [options]
Generate a server config for CasualOS.
Options:
-p, --pretty Pretty print the output.
-h, --help display help for command
validate-server-config$ casualos help validate-server-config
Usage: casualos validate-server-config [options]
Validate a server config for CasualOS.
Options:
--json <config> The JSON to validate.
-f, --file <file> The file to validate.
-h, --help display help for command
The CasualOS REPL allows you to interact with the CasualOS API using a Read-Eval-Print Loop (REPL).
It supports JavaScript and has a special function, query([procedure], [input]), that can be used to query the API. You can access it via the repl command.
After every evaluation, the _ variable will contain the result of the evaluation. Additionally, you can assign values to variables to store them for the entire session.
query([procedure], [input])The query() function can be used inside a REPL session to query the API of the currently set endpoint.
It accepts two optional parameters, procedure and input, and returns a promise that resolves with the result of the query. Because it returns a promise, you can use the await keyword on it to get the result of the query.
procedure should be a string and is the name of the procedure that should be executed. If omitted, then you will be prompted from a list of available procedures.
input can be any JavaScript value that matches the schema of the procedure. If omitted, then you will be prompted to fill in values for the procedure input.
To use query() in a REPL session, run await query(). This will start a query and wait until the query has a result. If you already know which operation you want to execute, you can run await query("procedureName"). This will skip the initial selector, but will still prompt you for inputs. If you already have the procedure and inputs, then you can run await query("procedureName", input). This will skip all prompts and will return the procedure result directly back to you.
If you don't provide an input, then query() will automatically prompt you for inputs based on the metadata of the procedure.
When answering prompts for query(), you can use a script by entering a . at the start of the input value. This will let you use the result of a JavaScript expression for the value. For example, when entering a string for expireTimeMs, you could write .Date.now() - (1000 * 60 * 60) to calculate 1 hour in the past in miliseconds. If you want to write a string that starts with a period (.), then just write two dots at the start. For example, instead of .myString, you would write ..myString. These special instructions only apply to the query() function inside repl, and not to the query command.
V3.3.11
data: The webhook will use the bots from a data record.file: The webhook will use the bots from a file record.inst: The webhook will use the bots from an inst record.
publicRead: The publicRead marker can be used to allow anyone to execute the webhook.private: The private marker can be used to only allow the record members to execute the webhook.createreadupdatedeletelistrunos.getWebhook() or by inspecting the webhook through the admin panel.os.recordWebhook(recordName, webhook)os.getWebhook(recordName, address)os.runWebhook(recordName, address, input)os.listWebhooks(recordName, address?)os.listWebhooksByMarker(recordName, marker, address?)os.eraseWebhook(recordName, address)os.toast(), os.showInput(), etc.)
os.recordData()).os.subscribeToNotification(recordName, address).os.sendNotification().publicRead: The publicRead marker can be used to allow anyone to read and subscribe to a notification.createreadupdatedeletelistsubscribeunsubscribelistSubscriptionssendos.recordNotification(recordName, notification)os.getNotification(recordName, address)os.eraseNotification(recordName, address)os.listNotifications(recordName, address?)os.listNotificationsByMarker(recordName, marker, address?)os.subscribeToNotification(recordName, address)os.unsubscribeFromNotification(recordName, address)os.sendNotification(recordName, address, payload)os.listNotificationSubscriptions(recordName, address)os.listUserNotificationSubscriptions()jsonObject form subtype.
gltf, but it uses ObjectLoader to load meshes from the URL specified in the formAddress tag.FAQs
Command line interface for CasualOS.
The npm package casualos receives a total of 22 weekly downloads. As such, casualos popularity was classified as not popular.
We found that casualos demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 0 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Research
Security News
Socket’s threat research team has detected six malicious npm packages typosquatting popular libraries to insert SSH backdoors.
Security News
MITRE's 2024 CWE Top 25 highlights critical software vulnerabilities like XSS, SQL Injection, and CSRF, reflecting shifts due to a refined ranking methodology.
Security News
In this segment of the Risky Business podcast, Feross Aboukhadijeh and Patrick Gray discuss the challenges of tracking malware discovered in open source softare.