# veld

> Open-source local development environment orchestrator. One command starts every service with real HTTPS URLs — no port numbers, no manual wiring. Works with monorepos, multi-repo setups, or any project directory.

veld is a Rust-based CLI tool that replaces the ritual of opening multiple terminals, remembering ports, and manually wiring services together. You declare your stack in a single `veld.json`, and veld resolves the dependency graph, allocates ports, starts processes, runs health checks, configures Caddy for HTTPS, and gives you clean URLs like `https://frontend.my-feature.myproject.localhost`.

- Source: https://github.com/prosperity-solutions/veld
- Website (homepage): https://veld.oss.life.li/
- Website (agent-friendly, structured): https://veld.oss.life.li/agents
- Website (human docs): https://veld.oss.life.li/humans
- License: MIT
- Platforms: macOS (arm64/x64), Linux (x64/arm64)

## Docs

- [Full Documentation](/llms-full.txt): Complete reference in a single request
- [README](https://raw.githubusercontent.com/prosperity-solutions/veld/main/README.md): Installation, quick start, CLI reference, architecture overview
- [Configuration Reference](https://raw.githubusercontent.com/prosperity-solutions/veld/main/docs/configuration.md): Full veld.json specification
- [JSON Schema](https://veld.oss.life.li/schema/v1/veld.schema.json): Machine-readable schema for veld.json

## Agent Skills

Install skills so your coding agent knows how to use Veld:

```sh
npx skills add prosperity-solutions/veld
```

Installs: **veld-config** (write veld.json), **veld-feedback** (human-in-the-loop reviews), **veld-usage** (CLI reference). Works with Claude Code, Cursor, Codex, Windsurf, and 40+ more agents.

## Optional

- [Releases](https://github.com/prosperity-solutions/veld/releases): Version history and release notes
- [Product Requirements](https://raw.githubusercontent.com/prosperity-solutions/veld/main/PRD.md): Design decisions and product context