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

# The Basics

> Getting started with Ghostable

<Warning>
  Ghostable CLI 1.x is legacy. Prefer the current [Desktop
  docs](/desktop/v1/getting-started/overview) or [CLI 2.x
  docs](/cli/v2/getting-started/installation) for new work.
</Warning>

## Creating Projects

Ghostable projects can be created using the Ghostable UI or the CLI:

```bash theme={null}
ghostable init
```

We recommend using the **Ghostable UI** if you’re starting fresh. It provides a streamlined
interface to name your project, assign it to an organization, and immediately begin managing
environments.

If you’re working with an **existing Laravel project**, run the `init` command inside your project
directory:

```bash theme={null}
ghostable init
```

This command will walk you through selecting an existing project or choosing
`[Create a new project]`. If you create a new project, you'll be prompted to enter its name. The
command then links the project to your local `.env` file and generates a `.ghostable.yml` config
file in the root of your project. This file tracks metadata like your project ID and environment
associations.

***

## Projects & Organizations

Before creating a project, make sure you're on the correct organization. You can list, check, or
switch organizations using:

```bash theme={null}
ghostable organization:list
ghostable organization:current
ghostable organization:switch
```

To view all projects for the current organization:

```bash theme={null}
ghostable project:list
```

Both `organization:list` and `project:list` display tables and require no interactive prompts.

## Deleting Projects

Projects can only be deleted through the [Ghostable web app](https://ghostable.dev). This action is
not available via the CLI.

When you delete a project, all associated environments and their stored `.env` data will be
permanently removed. This action is irreversible, so proceed with caution.

Ghostable does not delete any data outside of its own system. If you’ve pulled or synced `.env`
files to your local machine or other services, those copies will remain until removed manually.