Skip to main content

Viewing Projects

To list all projects for the current organization, run:
ghostable project:list
This command displays every project you have access to within your active organization — including project names, IDs, and associated environments. Project-specific settings such as notifications, access control overrides, and deployment settings can be managed through the Ghostable web app. From there, you can fine-tune project behavior, manage integrations, and review environment activity in one place.

Initializing Your Repository

Use the Ghostable CLI to initialize your repository and link it to an existing project (or create a new one):
ghostable init
This command walks you through selecting or creating a project, then generates a configuration file at .ghostable/ghostable.yaml — a safe, commit-friendly file that defines your project ID and environment associations.
Example
id: 0199f43c-7d56-7074-8fbc-6a96c4ecece8
name: my-project
environments:
    development:
        type: development
    local:
        type: local
    production:
        type: production
    testing:
        type: testing
It stores non-sensitive metadata such as your project ID and environment associations, making future commands and collaboration more convenient.

Deleting Projects

Projects can only be deleted through the Ghostable web app. This action is not available via the CLI. When you delete a project, all associated environments and their stored metadata 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.