# eph

> Ephemeral services per workspace: like .env files, but for services. A small Rust CLI that starts your dev services (Postgres, Redis, MinIO, your own app) isolated per workspace, with host ports assigned automatically.

You describe services in a `.eph` file. `eph up` starts them, namespaced by a hash of the workspace path so two checkouts never collide. `eval "$(eph env)"` loads the resolved connection strings into your shell. `eph down` stops them.

## User guide

- [eph User Guide](https://attunehq.github.io/doteph/guide/index.md): What eph is, and the reading order that takes you from zero to the full picture.
- [Getting Started](https://attunehq.github.io/doteph/guide/getting-started.md): Install eph, write your first .eph file, and run the core loop in five minutes.
- [Core Concepts](https://attunehq.github.io/doteph/guide/concepts.md): Workspaces, isolation, automatic ports, persisted state, and the service lifecycle.
- [The .eph File](https://attunehq.github.io/doteph/guide/eph-file.md): The complete file format: variables, services, every property, roles, and interpolation.
- [Defining Services](https://attunehq.github.io/doteph/guide/services.md): The four service sources, with ready-to-use definitions for common services.
- [Running Your App](https://attunehq.github.io/doteph/guide/run-your-app.md): Run your own app under eph: port=auto, eph dev, watch mode, and preview servers.
- [Shell Integration](https://attunehq.github.io/doteph/guide/shell-integration.md): Load resolved connection details into bash, zsh, fish, JSON, direnv, and your app.
- [Recipes](https://attunehq.github.io/doteph/guide/recipes.md): End-to-end setups: Compose migration, seeding, CI, prewarming, and secrets.
- [Troubleshooting](https://attunehq.github.io/doteph/guide/troubleshooting.md): The gotchas that bite, and how to diagnose a service that will not start.
- [Command Reference](https://attunehq.github.io/doteph/guide/command-reference.md): Every command, every flag, and what each one prints.
- [For Agents and Scripts](https://attunehq.github.io/doteph/guide/for-agents.md): A terse quick reference for AI coding agents and automation.

## Optional

- [Full guide as one file](https://attunehq.github.io/doteph/llms-full.txt): every chapter concatenated for a single fetch.
- [Source repository](https://github.com/attunehq/doteph): the CLI source, install scripts, and the developer guide.