Install & log in

edisyl runs in your own environment, so after installing the CLI you point it at your install’s API host and log in. Your edisyl admin has the host, usually https://api.<your-domain>.

1. Install the CLI.

   macOS / Linux

   curl -fsSL https://cli.edisyl.com/install.sh | sh

   Windows

   In PowerShell:

   irm https://cli.edisyl.com/install.ps1 | iex

   This installs edisyl.exe to %LOCALAPPDATA%\Programs\edisyl and adds it to your user PATH. Terminals that were already open need a restart to pick up the new PATH.

2. Point the CLI at your edisyl and log in.

   edisyl profile create work --endpoint https://api.<your-domain> --use
   edisyl login --profile work

   The first command saves your API host as a profile and makes it active. The second opens your browser to sign in, then saves the session for future commands.

3. Confirm who and where you are.

   edisyl whoami

   This prints your user and workspace. The workspace (org) is already provisioned: you’re joining it, not creating it.

   Run edisyl help to see the main commands, or edisyl <command> --help for any one of them.

Using a coding agent?

Run edisyl onboard and give your agent the output. It prints a self-contained guide to driving edisyl from the CLI: connecting a data source, teaching a pack, asking it questions, and tasking it with work. It needs no login and works offline.

Switch environments

There are two ways to switch:

• Log out and log back in. Run edisyl logout, then edisyl login and sign in with a different organization. This is simplest when you only move between them occasionally.
• Create a profile for each environment. A profile stores an endpoint, its sign-in session, and the selected org under one name. You can switch profiles without signing in again.

To add a profile for another environment, such as a staging install, create it the same way as above and log in to that profile. Order matters: a bare edisyl login authenticates default, not work.

Caution

-e/--env changes only the endpoint URL. It does not change the sign-in session. If you use it with an environment you have not logged in to, the command fails with unauthenticated. Use --profile to change both.

Three ways to select a profile, highest priority first:

Selector	Use when
--profile <name> / -p <name>	One-off override on a single command
EDISYL_PROFILE=<name>	Persistent for a shell session or in CI
edisyl profile use <name>	Change the default for all future commands

Tip: capture ids from any command with -j | jq -r '.id'. Every command supports -j/--json.

Next: Connect a data source.