> ## Documentation Index
> Fetch the complete documentation index at: https://docs.randomlabs.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Set up Slate and work on your first task.

# Quickstart Guide

<Warning>
  Slate may not work on Windows. If you are on Windows, we recommend using WSL (Windows Subsystem for Linux).
</Warning>

<Warning>
  Significant flashing and flickering has been observed in the TUI when running Slate inside tmux.
</Warning>

## Installation

Run the following command to install Slate:

```bash theme={null}
npm i -g @randomlabs/slate
```

Once installed, run Slate with:

```bash theme={null}
slate
```

## 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:

```bash theme={null}
cd /path/to/your/project
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.

<Note>
  What you should see: Slate shows your workspace path and Quick Start hints like `/help` and `/docs`.
</Note>

### Step 4: Try a Simple Task

Ask Slate to help you with a specific task:

```bash theme={null}
Please review the architecture of my entire codebase creating an ARCH.md and then give me ways I can improve it.
```

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:

<CardGroup cols={2}>
  <Card title="Using Slate" icon="book-open" href="/en/using-slate">
    Learn about all of Slate's features and commands.
  </Card>
</CardGroup>

## Need Help?

If you encounter any issues:

1. Check the [troubleshooting section](/en/using-slate/troubleshooting)
2. Reach out to our [team](mailto:team@randomlabs.ai)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.