diff --git a/state-hub/Makefile b/state-hub/Makefile
index 640b883..8ffd59d 100644
--- a/state-hub/Makefile
+++ b/state-hub/Makefile
@@ -2,6 +2,14 @@
 
 COMPOSE = docker compose -f infra/docker-compose.yml --env-file .env
 
+start:
+	@echo "# run in different terminals" 
+	@echo "make db           # docker compose up postgres"
+	@echo "make api          # start backend api"
+	@echo "make mcp-http     # start state-hub mcp service"
+	@echo "make dashboard    # Observable dev server on :3000"
+	@echo "make bridges      # Set up ssh bridges for cross machines access"
+
 install:
 	uv sync