# Tilt

> Manage and monitor Tilt dev environment resources. Use when checking build/deploy status, viewing logs, debugging failing resources, triggering rebuilds, or enabling/disabling services. Activates for any Tilt-related development workflow task.

- **Type:** Skill
- **Install:** `agentstack add skill-rrmistry-tilt-skill-tilt`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [rrmistry](https://agentstack.voostack.com/s/rrmistry)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [rrmistry](https://github.com/rrmistry)
- **Source:** https://github.com/rrmistry/tilt-skill/tree/main/skills/tilt

## Install

```sh
agentstack add skill-rrmistry-tilt-skill-tilt
```

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

## About

# Tilt Dev Environment Management

## Overview

This skill calls direct `tilt` CLI commands. All operations use the local `tilt` binary.

For advanced debugging workflows, see [workflows.md](workflows.md).

## Quick Reference

| Operation | Command |
|-----------|---------|
| List resources | `tilt get uiresource -o json` |
| Get logs | `tilt logs ` |
| Describe resource | `tilt describe uiresource ` |
| Trigger rebuild | `tilt trigger ` |
| Enable resources | `tilt enable  ` |
| Enable only these | `tilt enable --only  ` |
| Disable resources | `tilt disable  ` |
| Wait for ready | `tilt wait uiresource/ --for=condition=Ready --timeout=30s` |
| Wait for updated | `tilt wait uiresource/ --for=condition=UpToDate --timeout=30s` |

## Multi-Instance Support

By default, Tilt runs on port 10350. When working on multiple projects on the same dev machine, append `--port {port_number}` to any command to target a different Tilt instance (e.g. `tilt get uiresource -o json --port 10351`).

## Commands in Detail

### List All Resources with Status

```bash
tilt get uiresource -o json
```

Parse the JSON output to get resource status. Key fields per resource:
- `metadata.name` — Resource name
- `status.runtimeStatus` — `ok`, `error`, `pending`, `not_applicable`, `none`
- `status.updateStatus` — `ok`, `error`, `pending`, `in_progress`, `not_applicable`, `none`
- `status.disableStatus.state` — `Enabled` or `Disabled`
- `status.conditions[]` — Array with `type` (Ready/UpToDate), `status` (True/False), `reason`
- `status.buildHistory[0].error` — Latest build error (if any)

**Health status derivation:**
- **healthy**: runtimeStatus=ok AND updateStatus=ok/not_applicable
- **error**: runtimeStatus=error OR updateStatus=error
- **updating**: updateStatus in (in_progress, pending)
- **running**: runtimeStatus in (ok, pending)
- **not_started**: both statuses = "none" (manual trigger mode)
- **disabled**: disableStatus.state = "Disabled"

### Get Resource Logs

```bash
# Last N lines (native --tail flag, no piping needed)
tilt logs  --tail 200

# Show only errors/warnings (native --level flag)
tilt logs  --level error --tail 100

# Logs from last 5 minutes
tilt logs  --since 5m

# Only build logs or only runtime logs
tilt logs  --source build
tilt logs  --source runtime

# Combine native flags with grep for regex filtering
tilt logs  --tail 500 | grep -iE 'exception|traceback'

# Filter by request ID
tilt logs  | grep 'X-Request-Id: abc123'
```

### Describe Resource (Detailed Info)

```bash
tilt describe uiresource 
```

Returns configuration, conditions, build history, and current state.

### Trigger Resource Rebuild

```bash
tilt trigger 
```

Forces a rebuild/update of the resource. Useful for manual-trigger resources or to force a fresh build.

### Enable/Disable Resources

```bash
# Enable specific resources
tilt enable resource1 resource2

# Enable ONLY these (disables all others — saves system resources)
tilt enable --only resource1 resource2

# Disable specific resources
tilt disable resource1 resource2
```

### Wait for Conditions

```bash
# Wait for resource to be ready (most common)
tilt wait uiresource/ --for=condition=Ready --timeout=30s

# Wait for resource to be up-to-date
tilt wait uiresource/ --for=condition=UpToDate --timeout=30s
```

**Valid conditions:** `Ready`, `UpToDate`

**Before waiting**, always pre-check the resource status to avoid waiting on terminal failures:
1. If `disableStatus.state` = "Disabled" → enable it first
2. If `runtimeStatus` = "error" OR `updateStatus` = "error" → investigate the error, don't wait
3. If both statuses = "none" → trigger it first with `tilt trigger`
4. If both statuses = "not_applicable" → resource can't reach the condition

## Best Practices

1. **Always check status before waiting** — saves time on terminal failures
2. **Use `--only` when focusing** — conserves memory/CPU by disabling unused services
3. **Use native log flags first** — `--tail`, `--since`, `--level`, `--source` are more efficient than piping; use `grep` only for regex patterns not covered by native flags
4. **Check build errors first** — `tilt describe uiresource ` shows the latest build error at a glance
5. **Use JSON output for parsing** — always use `-o json` when you need to programmatically process resource data

## Source & license

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

- **Author:** [rrmistry](https://github.com/rrmistry)
- **Source:** [rrmistry/tilt-skill](https://github.com/rrmistry/tilt-skill)
- **License:** MIT

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:** no
- **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-rrmistry-tilt-skill-tilt
- Seller: https://agentstack.voostack.com/s/rrmistry
- 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%.