Servicemon

See and control your local development services across projects - in one dashboard.

Servicemon brings registered native services, tasks, and Docker Compose services into one localhost dashboard and CLI. Spend less time finding terminals, remembering service URLs, and checking what is running.

• See services by project. Check state and health, read logs, and start or stop the services you need.
• Open configured service links. Keep URLs with their services instead of remembering each port. Links come from config; Servicemon does not discover or enforce service ports.
• Keep your development commands. Use existing commands, their reload behavior, and Compose files.
• Share control with coding agents. Use the same registered services through the dashboard or CLI, with structured status and logs for agents.

One manager controls all registered projects from one YAML config. If Compose, Process Compose, or a few terminals already make your setup easy to manage, you may not need another tool. See the project vision.

Requires Node.js 24 or later. Docker and Docker Compose are needed only for Compose entries.

Currently supports macOS. Linux and Windows support is in progress.

Install

brew install sauravhiremath/tap/servicemon

Installation does not create config, start the manager, or enable login startup.

Agent skill (optional)

Install the Servicemon skill to help your coding agent set up projects, control services, and read logs:

npx skills add sauravhiremath/servicemon --skill servicemon --global

Select the agents to install it for. --global makes the skill available across projects for your user; omit it for a project-only installation. Homebrew does not install agent skills automatically.

First use

Create ~/.config/servicemon/config.yaml:

version: 1
projects:
  demo:
    directory: '~'
    services:
      api:
        command: 'echo ready; exec sleep 600'

Then run:

servicemon config validate
servicemon serve --background
servicemon start demo/api
servicemon status
servicemon dashboard
servicemon logs demo/api --tail 10

This starts demo/api, which prints ready and runs for 10 minutes. Replace its command and directory with your project's values. Only use config files you trust: their commands run as your user.

servicemon dashboard opens your default browser and prints the manager URL. You can also open that URL directly or bookmark it. There is no login or link expiry. All local users and processes can access the dashboard, read logs, and control configured services. Do not expose the port through a proxy or tunnel.

Use servicemon serve for foreground operation. Closing the browser stops nothing. Use servicemon manager stop to stop the manager and its owned processes and tasks. Compose containers remain running.

Controls

• Start resolves dependencies and waits for readiness. Stop affects only its selected target.
• Restart follows the configured recursive rules. An included stopped service stays stopped unless startup requires it.
• Run always runs a task again. Dependency starts reuse successful task results only in the current manager session.
• Health failures and process exits cause no automatic restart or stop.
• Manual config changes need servicemon reload. CLI definition edits apply immediately when the manager is available.
• A readiness timeout leaves the process running and its blocked dependents stopped.
• Use the dashboard to control services, filter entries, and view logs.

See the config reference, CLI reference, and dashboard guide for details.

Support and maintenance

For upgrades, login startup, removal, and recovery, follow the operations guide. Removing the program does not remove your config, retained logs, or Compose volumes.

Config commands and custom HTML are trusted local code. Status output, config, shell diagnostics, and logs can contain private data. Read CONTRIBUTING.md before reporting a defect.

Contributing

See CONTRIBUTING.md to build from source, run an isolated local manager, check changes, and report defects.

Limits

No file watching, remote access, native app, external-process attachment, or automatic recovery. Commands must load their own environment files. Use servicemon serve --ui <file> to replace the dashboard with your own HTML.

License

MIT. Copyright (c) 2026 Saurav M Hiremath.