# Tilt Dev

> 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.

- **Type:** Skill
- **Install:** `agentstack add skill-liatrio-labs-ai-prompts-tilt-dev`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [liatrio-labs](https://agentstack.voostack.com/s/liatrio-labs)
- **Installs:** 0
- **Category:** [Content & Media](https://agentstack.voostack.com/c/content-and-media)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [liatrio-labs](https://github.com/liatrio-labs)
- **Source:** https://github.com/liatrio-labs/ai-prompts/tree/main/skills/tilt-dev

## Install

```sh
agentstack add skill-liatrio-labs-ai-prompts-tilt-dev
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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:

```bash
# Run status check script
scripts/check_tilt_status.sh [port]

# Or manually
tilt get uiresources --port 
```

### Check Service Health

```bash
# 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:

```bash
tilt up --port 
```

Common ports: 10102, 10301, 10350

### View Logs

```bash
tilt logs --port  

# Follow logs
tilt logs --port   --follow
```

### Stop Tilt

```bash
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:` for:

- Real-time resource status
- Build logs
- Service restarts
- Error messages

## Common Workflows

### Debug Service Not Responding

1. Check Tilt UI resource status
2. View resource logs: `tilt logs --port  `
3. Check health endpoint with curl
4. Review error messages in logs

### View Recent Errors

```bash
# Tail logs for specific service
tilt logs --port   | tail -50

# Follow logs in real-time
tilt logs --port   --follow
```

### Diagnose Tilt Issues

```bash
tilt doctor
```

## Reference

See [references/tilt_commands.md](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 resources
- `scripts/get_service_health.sh` - Check health endpoints for common services

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [liatrio-labs](https://github.com/liatrio-labs)
- **Source:** [liatrio-labs/ai-prompts](https://github.com/liatrio-labs/ai-prompts)
- **License:** Apache-2.0

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** yes
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-liatrio-labs-ai-prompts-tilt-dev
- Seller: https://agentstack.voostack.com/s/liatrio-labs
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.