liatrio-labs/tilt-dev
skills/tilt-dev/SKILL.md
Manage local development environments with Tilt. Use when working with projects that run services via Tilt (indicated by presence of Tiltfile), including checking service status, viewing logs, troubleshooting connectivity issues, or managing the Tilt stack. Essential for projects using Tiltfile with local_resource for orchestrating backend, frontend, and other services.
$ install --global
skillsauthnpx skillsauth add liatrio-labs/ai-prompts tilt-devInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 6, 2026, 9:51 PM47.0s4 files scanned
SKILL.md
- name:
- tilt-dev
- description:
- Manage local development environments with Tilt. Use when working with projects that run services via Tilt (indicated by presence of Tiltfile), including checking service status, viewing logs, troubleshooting connectivity issues, or managing the Tilt stack. Essential for projects using Tiltfile with local_resource for orchestrating backend, frontend, and other services.
Tilt Development Environment Management
Manage and troubleshoot local development stacks orchestrated by Tilt.
Quick Start
Script paths shown as scripts/... assume your current working directory is skills/tilt-dev/. From repo root, use skills/tilt-dev/scripts/....
Check if Services Are Running
Always check before starting Tilt:
# Run status check script
scripts/check_tilt_status.sh [port]
# Or manually
tilt get uiresources --port <PORT>
Check Service Health
# Run health check script
scripts/get_service_health.sh
# Or manually check endpoints
curl http://localhost:3000/health # Backend
curl http://localhost:3001/ # Frontend
curl http://localhost:4111/swagger-ui # Mastra
Start Tilt
Only if services are not already running:
tilt up --port <PORT>
Common ports: 10102, 10301, 10350
View Logs
tilt logs --port <PORT> <resource>
# Follow logs
tilt logs --port <PORT> <resource> --follow
Stop Tilt
tilt down
Important Principles
Always Check First
Services are likely already running with hot reload. Never blindly run tilt up without checking status first.
Prefer Health Checks Over Restarts
Check health endpoints and logs before restarting services. Tilt hot-reloads changes automatically.
Use the Tilt UI
Access at http://localhost:<PORT> for:
- Real-time resource status
- Build logs
- Service restarts
- Error messages
Common Workflows
Debug Service Not Responding
- Check Tilt UI resource status
- View resource logs:
tilt logs --port <PORT> <resource> - Check health endpoint with curl
- Review error messages in logs
View Recent Errors
# Tail logs for specific service
tilt logs --port <PORT> <resource> | tail -50
# Follow logs in real-time
tilt logs --port <PORT> <resource> --follow
Diagnose Tilt Issues
tilt doctor
Reference
See references/tilt_commands.md for:
- Complete command reference
- Tiltfile (Starlark) syntax guidelines
- Project-specific examples
- Troubleshooting guide
- Port conventions
Scripts
scripts/check_tilt_status.sh [port]- Check if Tilt is running and list resourcesscripts/get_service_health.sh- Check health endpoints for common services
Related Skills
liatrio-labs/browser-qa
development
VerifiedTrustedCommunity
Use when you need lightweight browser QA for a web page, local HTML file, or app: inspect console errors, broken assets, keyboard/focus behavior, viewport readability, and publish evidence-backed findings JSON through a local HTML report viewer.
2SKILL.mdUpdated May 29, 2026
liatrio-labs/liatrio-dns
data-ai
VerifiedTrustedCommunity
Provision DNS records for liatr.io subdomains in the liatrio/liatrio-external-dns repository. Use when adding, modifying, or removing DNS CNAME records, A records, or other Route53 records for liatr.io or k8s-ignite.com domains. Triggers on requests like 'add a domain', 'create a subdomain', 'point X.liatr.io to Y', or 'set up DNS for a new site'.
2SKILL.mdUpdated May 8, 2026
liatrio-labs/uv-usage
development
VerifiedTrustedCommunity
Provides concise guidance for using uv (Python package manager), including project workflows, pip-compatible commands, Python version management, and PEP 723 inline script dependencies. Use when users mention uv, uv run, inline dependencies, PEP 723, or Python dependency/project management.
2SKILL.mdUpdated Apr 6, 2026
liatrio-labs/mastra-api
tools
VerifiedTrustedCommunity
Interact with Mastra development server API for debugging agents, viewing conversation threads, listing/inspecting tools and workflows, accessing observability data, and managing Mastra resources. Use when working with Mastra agents and need to inspect runtime state, debug agent errors, view thread history, see available tools/workflows, or access API endpoints at localhost:4111/api or similar ports.
2SKILL.mdUpdated Apr 6, 2026