SuperShell
Sign inInstall

Get started with the SuperShell CLI

Install the CLI, connect a model provider, and start your first conversation.

Last updated

On this pageInstall the CLIOpen a projectGive it a first taskChoose a runtimePick up later

Install the CLI

macOS Apple silicon + Intel, Linux x64 + arm64. No Node needed. No SuperShell account is needed.

sh
curl -fsSL https://supershell.ai/install | sh
supershell

Run supershell update to update. Cloud is optional via /cloud.

Open a project

Switch to the folder you want the agent to work in:

sh
cd your-project
supershell

Choose a runtime with /runtime, then connect a model with /login: OpenRouter, OpenAI, Anthropic, or ChatGPT/Claude sign-in. Use /model to choose a model. Run /setup to check the installation. Provider usage is governed by your provider account.

Give it a first task

Ask “explain this project's test setup.” Review any permission request before allowing tools to run. Press Esc to interrupt. Use /help to see commands and shortcuts.

Choose a runtime

Use /runtime to choose SuperShell, Claude Code, or Codex. Claude Code and Codex need their installed CLI and their own login. See the runtime instructions.

Pick up later

sh
supershell --continue

This reopens the most recent conversation. For terminal linking, see the Cloud guide.