Account & CLI
These commands run in the CLI only. Account setup is not available in MCP.
Sign in
Section titled “Sign in”edisyl login opens your browser and shows a code to enter there. When you finish signing in, it saves the sign-in session for later commands. Without --profile, it saves the session to the default profile.
edisyl init # create the config directoryedisyl login [--profile <name>] # sign in through the browseredisyl whoami # which user and organization you're inedisyl logout # revoke the session and clear stored credentialsedisyl update [--check] # install the latest CLI buildedisyl onboard # print a guide to the CLI for an AI agentedisyl config set auto-update true|false # turn automatic CLI updates on or offedisyl config show # print the current profile's configurationlogout clears local credentials even if the server can’t be reached. update downloads the build for your platform from cli.edisyl.com, verifies its checksum, and replaces the binary in place. edisyl config set auto-update true|false turns automatic updates on or off. edisyl config show prints the current profile’s configuration. onboard prints markdown written for an LLM agent. You can safely pipe it into a system prompt. It needs no sign-in and makes no server call.
Profiles
Section titled “Profiles”A profile stores an endpoint, its sign-in session, and the selected org under one name. You can switch environments in two ways. Run edisyl logout and sign in to a different organization, or create a profile for each environment and switch between them.
-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.
| Selector | Use when |
|---|---|
--profile <name> / -p <name> |
You want a different profile for one command only |
EDISYL_PROFILE=<name> |
You want a profile for a whole shell session or a CI job |
edisyl profile use <name> |
You want to change the default for all future commands |
edisyl login without --profile signs in to the default profile, not to a profile you created. To sign in to another profile, pass --profile.
edisyl profile create local --use # create and activate; local, dev and prod infer their endpointedisyl profile create preview --endpoint https://preview-api.example.comedisyl profile listedisyl profile show [name]edisyl profile set <name> endpoint|org-id|org-slug <value>edisyl profile delete <name>Profiles are stored in ~/.config/edisyl/config.yaml. The file has 0600 permissions because it holds your session credentials.
Global flags
Section titled “Global flags”| Flag | Behavior |
|---|---|
-j, --json |
Machine-readable output on every command. |
--quiet |
On action and schedule read commands, hide hints and banners and show only the data. |
-h, --help |
Usage, flags and examples for any command. edisyl help <command> does the same. |
For anything not covered here, edisyl <command> --help is the authoritative source. edisyl help without a command lists the main commands.
Permissions
Section titled “Permissions”The CLI does not check permissions itself. It calls the endpoint and shows you the response, including a 403. What you can do depends on your org role and your capabilities on the pack. A 403 means you don’t have the permission. It does not mean the command or its arguments are wrong. Retrying with different flags won’t help.
Was this page helpful?
Thanks for the feedback.
