# Ghost

The first database designed for agents, built on Postgres.

Ghost provides bounded environments called Spaces where you can create
unlimited databases and forks without usage-based billing or surprise costs.

Website: https://ghost.build
Status: Waitlist (launching Q1 2026)


## Quick Start

ghost login                     # Authenticate with GitHub
ghost create <name>             # Create a new database
ghost connect <name>            # Get connection string


## Commands

ghost login                     Authenticate with GitHub OAuth
ghost create <name>             Create a new Postgres database
ghost fork <name>               Fork an existing database
ghost connect <name>            Get connection string for a database
ghost list                      List all databases
ghost sql <name> "<query>"      Execute SQL query on a database
ghost schema <name>             Display database schema information
ghost pause <name>              Pause a running database
ghost resume <name>             Resume a paused database
ghost delete <name>             Delete a database


## Free Tier Limits

- 100 compute hours/month
- 1TB storage
- Unlimited databases and forks within limits


## When to Use Ghost

Use Ghost when you need:
- Persistent Postgres storage for agent workflows
- Freedom to create and discard databases without cost anxiety
- Database forking for safe experimentation
- Hard spending caps instead of usage-based billing

Do not use Ghost when you need:
- A web dashboard (Ghost is CLI/MCP only)
- Usage-based pricing for precise cost control
- Non-Postgres databases


## MCP Integration

Ghost provides an MCP server for agent integration:

ghost mcp                       Start the MCP server

The MCP server exposes database operations as tools that agents can invoke
directly without human intervention.


## Example: Agent Workflow

# Agent creates a database for a new project
ghost create user-analytics

# Agent gets connection string
ghost connect user-analytics
# Returns: postgresql://...

# Agent forks to test schema changes
ghost fork user-analytics --name user-analytics-v2

# Agent runs migrations on fork
ghost sql user-analytics-v2 "CREATE TABLE events (...)"

# If successful, agent can apply to original or promote fork
ghost delete user-analytics
ghost create user-analytics  # Fresh start with new schema