Skip to main content

Quickstart Guide

Slate may not work on Windows. If you are on Windows, we recommend using WSL (Windows Subsystem for Linux).
Significant flashing and flickering has been observed in the TUI when running Slate inside tmux.

Installation

Run the following command to install Slate:
Once installed, run Slate with:

Your First Task

Let’s complete a simple task to get familiar with Slate.

Step 1: Start Slate in Your Project

Navigate to your project directory and initialize Slate:

Step 2: Sign In

On a fresh launch, Slate requires authentication with Random Labs. Press Enter to begin device authorization, then complete the browser flow with the code shown in the terminal.

Step 3: Complete First-Run Setup

Onboarding asks for your terminal background, multiline input preference, and model source: your ChatGPT/Codex subscription, SuperGrok subscription, or Slate credits. Press Esc to skip onboarding, and run /onboarding to restart it later.
What you should see: Slate shows your workspace path and Quick Start hints like /help and /docs.

Step 4: Try a Simple Task

Ask Slate to help you with a specific task:
Slate will search through your files and analyze the entire codebase, and then review the results to understand how to improve it.

Next Steps

Now that you’re up and running, explore Slate’s full capabilities:

Using Slate

Learn about all of Slate’s features and commands.

Need Help?

If you encounter any issues:
  1. Check the troubleshooting section
  2. Reach out to our team