# Devservers Register Service

> 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). Use when this capability is needed.

- Skill: `tomevault-io/devservers-register-service` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/devservers-register-service`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/devservers-register-service/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/devservers-register-service

---


# 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.

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/atimmer) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->