| name | local-services |
| description | Start, stop, and check local development services with intelligent minimum-set management. Trigger when services need to be running for functional verification or manual testing — starts the minimum required set (infrastructure + tgo-api + tgo-ai) by default, with optional extras auto-detected from git diff or specified manually. Includes status checking and graceful shutdown. |
local-services
Purpose
Start, stop, and check local development services. Knows the minimum required set and can auto-detect additional services needed based on code changes.
Trigger
- Before running functional verification (services must be running)
- When starting a development session
- When agent needs to test API changes at runtime
Minimum Services
The core platform requires only 3 things to be functional:
- Infrastructure — PostgreSQL, Redis, WuKongIM (
make infra-up)
- tgo-api — Core API gateway (port 8000)
- tgo-ai — LLM / Agent runtime (port 8081)
All other services are optional and can be added based on what you're working on.
Service Map
| Service | Make target | Port | When needed |
|---|
| Infrastructure | make infra-up | 5432/6379/5001 | Always |
| tgo-api | make dev-api | 8000 | Always |
| tgo-ai | make dev-ai | 8081 | Always |
| tgo-rag | make dev-rag | 18082 | Knowledge base / RAG changes |
| tgo-platform | make dev-platform | 8003 | Channel integration changes |
| tgo-workflow | make dev-workflow | 8004 | Workflow engine changes |
| tgo-plugin-runtime | make dev-plugin | 8090 | Plugin / MCP tool changes |
| tgo-device-control | make dev-device | 8085 | Device management changes |
| tgo-web | make dev-web | 5173 | Admin frontend changes |
| tgo-widget-js | make dev-widget | 5174 | Visitor widget changes |
| RAG worker | make dev-rag-worker | — | Document processing tasks |
| Workflow worker | make dev-wf-worker | — | Workflow execution tasks |
Usage
bash .skills/local-services/scripts/start.sh
bash .skills/local-services/scripts/start.sh rag web
bash .skills/local-services/scripts/start.sh --auto
bash .skills/local-services/scripts/start.sh --all
bash .skills/local-services/scripts/status.sh
bash .skills/local-services/scripts/stop.sh