Dev → Test → Promote

Lifecycle

create → dev → test → promote

Dev

Start the agent against the local control plane:

mesh dev my-agent

The agent registers on the mesh, discovers tools, and is ready to receive calls. Other agents can find it via discovery.

Test

Run validation checks:

mesh test my-agent

Checks: schema validity, Python imports, required files, manifest completeness.

Promote

Deploy to the target mesh:

mesh promote my-agent --dry-run    # Preview first
mesh promote my-agent              # Copy + auto-start

Promotion:

1. Validates all checks pass
2. Bumps the version (1.0.0 → 1.0.1)
3. Snapshots the agent files for rollback
4. Copies to the target mesh directory
5. Auto-starts the agent on the control plane

Versioning

Each promotion bumps the patch version and saves a snapshot:

agents/my_agent/.versions/
  1.0.1/    # Snapshot of promoted files
  1.0.2/    # Next promotion

Rollback to any version:

curl -X POST localhost:8100/agents/my-agent/rollback/1.0.1

Dirty State

State	Meaning
unpromoted	Agent exists in dev but never promoted
files_changed	Dev copy differs from promoted
clean	Dev matches promoted