Skip to main content
Unlisted page
This page is unlisted. Search engines will not index it, and only users having a direct link can access it.

Terminal Guide

You can use AdaL even if you have never used a terminal before. This guide walks you through opening a terminal, installing AdaL, and starting your first session.

Prefer not to use the terminal?

Download the Desktop app for macOS Apple Silicon.

macOS, Linux, and WSL​

1. Open a terminal​

macOS: Press Cmd + Space, type Terminal, and press Enter.

Linux: Open your terminal app. On most distributions, press Ctrl + Alt + T or search for "Terminal" in your application menu.

WSL on Windows: Open Windows Terminal and choose your Linux distribution, such as Ubuntu.

A terminal window shows a prompt with a blinking cursor. This is where you paste commands.

2. Install AdaL​

Copy this command, paste it into your terminal, and press Enter:

curl -fsSL https://adal.sylph.ai/install.sh | bash

This downloads and runs the AdaL native installer. When it completes, close and reopen your terminal if the adal command is not recognized immediately.

3. Start AdaL​

Go to the folder where you want to work, then run:

adal

On first launch, AdaL opens a browser for authentication. Follow the sign-in flow, then return to your terminal.

Windows​

1. Open PowerShell​

Press Win + X and select Terminal or Windows PowerShell.

PowerShell prompts usually start with PS, for example:

PS C:\Users\YourName>

If you are in Command Prompt instead, the prompt usually looks like:

C:\Users\YourName>

If irm is not recognized, you're probably in CMD, not PowerShell. Use the CMD command below or open PowerShell.

2. Install AdaL​

In PowerShell, paste this command and press Enter:

irm https://adal.sylph.ai/install/windows | iex

If you are in Command Prompt, run PowerShell through this command:

powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://adal.sylph.ai/install/windows | iex"

3. Start AdaL​

Close and reopen PowerShell so Windows picks up the new adal command, then run:

adal

On first launch, AdaL opens a browser for authentication. Follow the sign-in flow, then return to your terminal.

Plan and 7-day trial​

AdaL requires an active plan to use the CLI. See Pricing for plan options.

Eligible new users can claim a 7-day free Pro trial from the Dashboard. If you qualify, you’ll see a Try Pro free for 7 days banner after signing in.

npm fallback​

The native installers are recommended. Use npm only if the native installer does not fit your environment:

npm install -g @sylphai/adal-cli

npm requires Node.js 20+.

Basic terminal tips​

  • Paste commands exactly as shown.
  • Press Enter to run a command.
  • Use the arrow keys to move through command history.
  • If a command is running and you want to stop it, press Ctrl+C.
  • In AdaL, type /help to see available commands.
  • Type /quit to exit AdaL.