dss/dss-claude-plugin/commands/dss-services.md

name, description, arguments

name	description	arguments
dss-services	Manage all DSS development services (API, admin-ui, Storybook)	name description required action Action to perform (start, stop, status, restart, logs) true name description required service Specific service (api, admin-ui, storybook) - optional false

DSS Services Command

Manage all DSS development services from a single command.

Usage

/dss-services <action> [service]

Actions

Action	Description
start	Start all services (or specific service)
stop	Stop all services (or specific service)
status	Show status of all services
restart	Restart all services (or specific service)
logs	Show service logs

Services

Service	Port	Description
api	6220	FastAPI REST server
admin-ui	6221	Vite dev server
storybook	6226	Storybook design docs

Examples

# Start all services
/dss-services start

# Check status
/dss-services status

# Start only the API server
/dss-services start api

# Stop Storybook
/dss-services stop storybook

# View admin-ui logs
/dss-services logs admin-ui

# Restart everything
/dss-services restart

Instructions for Claude

When the user runs this command:

1. Execute: scripts/dss-services.sh <action> [service]

2. Present the output in a clean format

3. For status action, show a table with service states

4. After start, provide clickable URLs:

   • API: http://localhost:6220
   • admin-ui: http://localhost:6221
   • Storybook: http://localhost:6226

Service Details

API Server (port 6220)

• FastAPI REST API
• Endpoints: projects, figma, health, config
• Command: uvicorn apps.api.server:app --host 0.0.0.0 --port 6220 --reload
• Log: /tmp/dss-api.log

Admin UI (port 6221)

• Preact/Vite development server
• Design system management interface
• Command: npm run dev
• Log: /tmp/dss-admin-ui.log

Storybook (port 6226)

• Component documentation
• Token visualization
• Command: npm run storybook
• Log: /tmp/dss-storybook.log

Troubleshooting

If a service fails to start:

1. Check the log file: /dss-services logs <service>
2. Verify port is not in use: lsof -i :<port>
3. Check dependencies are installed

Related Commands

• /dss-init - Full environment setup + initialization
• /dss-reset - Reset to clean state