devservers-register-service

name	devservers-register-service
description	Register a dev server using the CLI. Use when an agent needs to add/update/remove a service entry (name, cwd, command, env, port, port mode).

Devservers Register Service

Overview

Register a service via the CLI so it can be managed. Optionally start it if requested. Rule: Use CLI only. Do not edit config files directly or interact with internal services.

Workflow

Quick overview of available CLI commands:

devservers --help

1) Gather inputs

Collect:

• name (alphanumeric plus ._-)
• cwd (absolute path)
• command (shell command, e.g. pnpm dev)
• optional env entries (KEY=VALUE)
• optional port
• optional port mode (static, detect, registry)

Ask if the user wants the service started immediately.

2) Register via CLI

CLI (from anywhere):

devservers add \
  --name <name> \
  --cwd <absolute-path> \
  --command "<command>" \
  --port <port> \
  --port-mode <mode> \
  --env KEY=VALUE

• --port, --port-mode, and --env are optional.
• Repeat --env for multiple vars.

Verify:

devservers list

URL lookup (when running):

devservers url <name>

3) Start service (optional)

Start via CLI:

devservers start <name>

4) Troubleshoot

• If a CLI call fails due to connectivity, ask the user to start the manager and retry.