~/your-project

One command to go from git clone to a running dev environment. devme reads your project config, installs dependencies, starts services, and drops you into a live TUI. No README needed.

$brew install devme-sh/tap/devme󰆏copy

See it in action

$

Features

󰌾Declarative env vars

Declare expected variables in devme.toml with defaults, help text, and auto-generate commands. New team members get prompted automatically.

󰒃Dependency checks

Steps verify prerequisites before services start. Missing Node.js? devme offers to install it. All checks pass? One clean line.

󰚡Service orchestration

Postgres, Redis, your API, your frontend — started in dependency order with health checks. Like docker-compose but for your whole dev stack.

󰒉Live TUI

A real terminal UI with per-service log streams, scrollback, filtering, and keyboard navigation. Not just interleaved stdout.

󰄦Multi-worktree

Working on two branches? Each git worktree gets its own devme instance with isolated ports. No conflicts.

󰃡No README maintenance

The setup instructions are the config file. devme.toml is the source of truth — always up to date, never stale.


How it works

# 1. Add a devme.toml to your repo schema_version = 1 [env.DATABASE_URL]default = "postgresql://localhost:5432/dev"help = "Connection string for the dev database" [step.deps]check = "test -d node_modules"provision = "bun install" [service.db]cmd = "docker run --rm -p {port}:5432 postgres:17"port = { base = 5432, slot_offset = 10 } [service.web]cmd = "bun run dev"depends_on = ["deps", "db"] # 2. Run devme$ devme# That's it. Environment configured, deps installed, services running.