Sigil

One config. Full stack.

sigil.config.ts

import { Environment, Postgres, Service, APIInterface } from "sigil";

const env = new Environment("my-app");

const db = env.add(
  new Postgres("db", {
    database: "myapp",
    initSql: "./schema.sql",
    seedSql: "./seed.sql",
  })
);

env.add(
  new Service("api", {
    command: ["node", "server.js"],
    env: { DATABASE_URL: db.connectionString },
    readyCheck: { url: "http://localhost:3000/health" },
  }, [new APIInterface(3000)])
);

export default env;

Terminal

$ sigil up
[sigil] Starting environment "my-app"...
[sigil] Starting entity: db
[sigil] Pulling image postgres:16...
[sigil] Container sigil-db started on port 5432
[sigil] Starting entity: api
[api] Server listening on port 3000
[sigil] All entities started. Press Ctrl+C to stop.

$ sigil status
Instance: default (PID 42069, running, started 3m ago)
  Config: /app/sigil.config.ts
  Entities:
    db                   running
    api                  running

$ sigil down
[sigil] Stopping instance "default"...
[sigil] Instance stopped

---

How it works

1. Define your stack in a sigil.config.ts — databases, services, frontends

2. Run sigil up — Sigil starts everything in dependency order, wires connection strings, and waits for readiness

3. Develop against real infrastructure — Docker Postgres, live processes, actual ports

4. Tear down with sigil down or Ctrl+C — clean shutdown in reverse order

---

Built different

Declarative

TypeScript config, not YAML. Full type safety, IDE autocomplete, and the ability to compute values like connection strings at definition time.

Docker-native

Databases run in real Docker containers. Services run as native processes with Bun.spawn. No emulation, no mocks — real infrastructure.

Agent-first

Coding agents need realistic stacks to test against. Sigil gives them Postgres with real data, APIs with health checks, and full-stack environments — not toy sandboxes.

LLM-friendly

These docs ship /llms.txt and /llms-full.txt for single-fetch ingestion. Your agent can read the entire Sigil API in one request.

---

Dive in

Quickstart Your first environment in 5 minutes

Full-Stack Example Postgres + FastAPI + React — the complete walkthrough

CLI Reference Every command, flag, and exit code

Concepts Entities, Interfaces, and the lifecycle model