CLI (Preview Version)
Overview
The Neurelo CLI is a tool that helps you to use some of Neurelo’s features programmatically from outside of the UI. You can download the latest version from the Neurelo dashboard. Neurelo's CLI is currently supported for the following operating systems -
MacOS 64-bit (ARM and Intel based)
Linux 64-bit (ARM and Intel based)
Installation
Visit https://dashboard.neurelo.com and navigate to the user menu on the top right. Click on the "Download CLI" button. You will be redirected to the download page where you can find different versions of the CLI to download for your preferred platform (Mac or Linux are both available).
After downloading the binary, please ensure it's executable by executing
chmod +x ./binary-path-here

MacOS Specific Installation Instructions
You might be warned that this application is from an unknown developer. To bypass this, simply open the Security and Privacy pane in the System Settings of your mac, scroll down in that page, and press 'Open Anyway' next to the Neurelo CLI binary name. You'll be prompted once more when trying to run the binary - click 'Open Anyway', and then you will be able to use the CLI.
Modes
Neurelo CLI supports two modes of operations - an interactive mode and a non-interactive mode. In the interactive mode, you can enter the command without options, and you will be prompted with responses for the next steps. In the non-interactive mode, you can enter the full command, including options, and the necessary action(s) will be performed without prompts.
- Interactive Mode
This is the mode the CLI will be in when you enter the command with no sub-options and press the Enter key. You will then be prompted on the next steps through the responses. This mode is useful when you are interacting live with the CLI as a user.
- Non-Interactive Mode
This is the mode in the CLI when you enter the full command, including its sub-options, on one line and press the Enter key. The necessary action(s) will be performed without prompts.
Commands
To check if the installation was successful, use the following command to display the available options for Neurelo’s CLI:
$ neurelo
Output similar to the following is displayed:
Usage: neurelo [command] [options]
CLI to interact with Neurelo's Data Access Platform
Options:
-h, --help Display all the options
Commands:
login Authenticate the user utilizing the Neurelo CLI
project Interact with projects
env Interact with environments from the selected project
commit Interact with commits from the selected project
datasource Interact with data sources from the selected project
branch Interact with branches from the selected project
sdk Interact with Neurelo SDKs
login
To use the Neurelo CLI, you must first login with the following command which will be redirected automatically to Neurelo's dashboard to proceed with the authentication.
$ neurelo login
After successful login, you can start using the CLI.
The session is valid for 1 hour after being authenticated. You may need to re-login after the session expires.
You can also create a machine user
for using the CLI. Please refer to this documentation for creating and using a machine user.
project
This command provides support for all the projects that user has access to. The following subcommands are available for use with theproject
command:
get
Return the information from an specific project.
Interactive mode:
$ neurelo project get
Options:
—-id
String of project id to be retrieved.$ neurelo project get --projectId <projectId>
ls
Return a list of all projects that the current user has access to.
$ neurelo project ls
use
Select a project to use as part of the CLI session context.
This subcommand is useful for interacting with other Neurelo features such as environments.
Interactive mode:
$ neurelo project use
Options:
—-id
String of project id that will be used for the session context.$ neurelo project use --projectId <projectId>
env
This command provides support for working with the environments that user has access to in the selected project.
Remember to select a project with `neurelo project use` first
Check the following subcommands to use with env
command:
get
Return the information from a specific environment, such as environment id, environment name, project name, and the organization name.
Interactive mode:
$ neurelo env get
Options:
—-id
(String) Environment id to be retrieved$ neurelo env get --environmentId <environmentId>
use
Select an environment to use as part of the CLI session context
This subcommand is needed for interacting with other features that specific environment.
Interactive mode:
$ neurelo env use
Options:
--id
String of environment id that will be selected as part of session context.$ neurelo env use --environmentId <environmentId>
add
Create a new environment for a selected project.
Interactive mode:
$ neurelo env add
Options:
If you use this subcommand with options, all options are required except for those marked as optional.
—-name
(String) Name for the new environment—-region
(String) Region for the environment [us-east-2
/us-west-2
]—-commitId
(String) Commit ID that will be selected for environment. Hint: Get the commit id withneurelo commit ls
command.—-datasourceId
[Optional] (String) Datasource id that will be attached to environment. Hint: Get data source id withneurelo datasource ls
$ neurelo env add --name <name> --region <region> --commitId <commitId> --datasourceId <dataSourceId>
ls
Return a list of all environments that current user has access to within the selected project.
$ neurelo env ls
update
Update the configuration for a selected environment. Currently the CLI supports updating the commit id. To use this subcommand it is necessary to select environment with
neurelo env use
Interactive mode:
$ neurelo env update
Options:
--commitId
(String) Commit ID that will be updated$ neurelo env update --commitId <commitId>
start
Start the runners for the selected environment
$ neurelo env start
stop
Stop the runners for the selected environment
$ neurelo env stop
commit
This command provides support for working with the commits in a project that the user has access to
Check the following subcommands to use with commit
command:
ls
Return a list of all commits in the selected project. If you use interactive mode, this will retrieve from default branch, otherwise if you use the option specifying the branch it will return a list from selected branch.
Interactive mode (Default branch):
$ neurelo commit ls
Options:
--branch
(String) Branch ID that will be selected to get the commit list.$ neurelo commit ls --branch <branchId>
datasource
This command provides support for working with the data sources that the user has access to
Check the following subcommands to use with thedatasource
command:
attach
Attach a data source to the selected environment. To use this subcommand, first select the environment with
neurelo env use
Options:
--id
(String) Data source id to be attached to environment.$ neurelo datasource attach --dataSourceId <datasourceId>
detach
Detach a data source from the selected environment. To use this subcommand select the environment with
neurelo env use
Options:
--id
(String) Data source id that will be detached from environment$ neurelo datasource detach --dataSourceId <datasourceId>
ls
Return a list of all data sources in the selected environment.
$ neurelo datasource ls
rm
Delete a data source from the selected project
Options:
--id
String of data source id that will be deleted$ neurelo datasource rm --dataSourceId <datasourceId>
branch
This command provides support for working with the branches that the user has access to.
Check the following subcommand to use with the branch
command:
ls
Return a list of all branches available in selected project.
$ neurelo branch ls
sdk
This command provides support for downloading the sdks that user can use from selected project.
Check the following subcommands to use with the sdk
command:
download
Download the sdk for a specific language given the commit id.
Interactive mode:
$ neurelo sdk download
Options:
--language
(String) SDK type to download [typescript/python/golang]--commitId
(String) Commit ID for which the SDK will be downloaded$ neurelo sdk download --language <languageName> --commitId <commitId>
Last updated