Run any Skill in Manus with one click

local-services

Stars528

Forks102

UpdatedMarch 11, 2026 at 11:08

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.

Installation

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

Run Skill in Manus

Source

tgoai

tgoai/tgo

View GitHub Repository View Creator Repositories

Download

Run Skill in Manus

Related occupationsSOC

Based on SOC occupation classification

Network and Computer Systems AdministratorsComputer and Mathematical Occupations·SOC 15-1244

File Explorer

4 files

SKILL.md

readonly

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

# Start minimum services (infra + api + ai)
bash .skills/local-services/scripts/start.sh

# Start minimum + specific extras
bash .skills/local-services/scripts/start.sh rag web

# Start minimum + auto-detect extras from git diff
bash .skills/local-services/scripts/start.sh --auto

# Start everything
bash .skills/local-services/scripts/start.sh --all

# Check what's running
bash .skills/local-services/scripts/status.sh

# Stop all services
bash .skills/local-services/scripts/stop.sh

More from this repository

same repository

code-change-verification

tgoai/tgo

Run lint, type-check, and build verification for changed services after code modifications are complete. Trigger after any code change to repos/*/ — auto-detects which services were touched via git diff and runs the appropriate static checks (mypy/flake8 for Python, type-check/lint/build for TypeScript, go vet for Go).

2026-03-11528

cross-service-sync

tgoai/tgo

Detect schema, type, or API interface changes and find files in other services that may need synchronized updates. Trigger when modifying files under schemas/, types/, or interfaces/ directories — extracts changed class/type names from the diff and searches all other services for references, outputting a list of potentially stale consumers.

2026-03-11528

functional-verification

tgoai/tgo

Use tgo-cli (staff) and tgo-widget-cli (visitor) to verify API and service changes at runtime, beyond static lint/build checks. Trigger after modifying backend API endpoints, service logic, chat flow, agent config, knowledge/RAG, workflow, or platform integration — requires local services to be running. Auto-detects changed services from git diff and runs the corresponding CLI smoke tests (system info, CRUD listing, chat e2e).

2026-03-11528

implementation-strategy

tgoai/tgo

Analyze change impact across services before starting implementation. Trigger before modifying runtime, API, or cross-service code — maps changed files to service ownership, outputs the dependency graph between affected services, and lists upstream/downstream sync points that may need coordinated updates.

2026-03-11528

streaming-protocol-check

tgoai/tgo

Check streaming protocol consistency across all producer and consumer services. Trigger when modifying code related to streaming, SSE, WuKongIM, json-render, or MixedStreamParser — lists all files in tgo-ai (producer), tgo-api (relay), tgo-web, tgo-widget-js, and tgo-widget-miniprogram (consumers) that handle the same protocol and may need coordinated updates.

2026-03-11528

db-migration-check

tgoai/tgo

Verify that SQLAlchemy model changes have corresponding Alembic migration files. Trigger when any file under models/*.py or models/**/*.py is modified — checks git diff for model changes and confirms matching alembic/versions/*.py files exist, failing if a service has model changes without a migration.

2026-03-11528

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

# Start minimum services (infra + api + ai)
bash .skills/local-services/scripts/start.sh

# Start minimum + specific extras
bash .skills/local-services/scripts/start.sh rag web

# Start minimum + auto-detect extras from git diff
bash .skills/local-services/scripts/start.sh --auto

# Start everything
bash .skills/local-services/scripts/start.sh --all

# Check what's running
bash .skills/local-services/scripts/status.sh

# Stop all services
bash .skills/local-services/scripts/stop.sh