hack-cli
Use the hack CLI for local dev environments (docker compose, logs, run commands) and agent integration setup. Trigger when asked to start/stop services, open project URLs, inspect logs, run commands in services, manage branch instances, or configure agent integrations (Cursor/Claude/Codex/MCP). Prefer CLI over MCP when shell access is available.
When & Why to Use This Skill
The hack-cli skill is a powerful command-line interface designed to bridge the gap between AI agents and local development environments. It enables seamless management of Docker Compose services, real-time log monitoring, and complex command execution across multiple branch instances. By automating the setup for AI tools like Cursor, Claude, and MCP, it significantly enhances developer productivity and streamlines the local dev-to-agent workflow.
Use Cases
- Local Environment Orchestration: Effortlessly start, stop, and manage Docker services or open project URLs using natural language via the hack CLI.
- Advanced Debugging and Log Analysis: Tail logs across multiple services, filter by Loki history, or capture JSON snapshots to quickly identify and resolve local development issues.
- Parallel Branch Management: Run and manage parallel development environments for different feature branches to test changes in isolation without environment conflicts.
- AI Agent Integration Setup: Automatically configure Cursor rules, Claude hooks, and MCP settings to optimize how AI coding assistants interact with your specific project structure.
| name | hack-cli |
|---|---|
| description | > |
hack CLI
Use hack CLI as the primary interface for local dev.
Quick Start
- Start services:
hack up --detach - Open app:
hack open --json - Tail logs:
hack logs --pretty - Snapshot logs:
hack logs --json --no-follow - Run commands:
hack run <service> <cmd...> - Stop services:
hack down
Branch Instances
Use branch instances to run parallel environments:
hack up --branch <name> --detachhack open --branch <name>hack logs --branch <name>hack down --branch <name>
Logs
- Loki history:
hack logs --loki --since 2h --pretty - Filter services:
hack logs --loki --services api,web - Force compose logs:
hack logs --compose
Project Targeting
- Run from repo root when possible.
- Otherwise use
--project <name>or--path <repo-root>. - List projects:
hack projects --json.
Daemon (optional)
- Start for faster JSON status/ps:
hack daemon start - Check status:
hack daemon status
Agent Setup
- Cursor rules:
hack setup cursor - Claude hooks:
hack setup claude - Codex skill:
hack setup codex - Init prompt:
hack agent init(use --client cursor|claude|codex to open) - Init patterns:
hack agent patterns - MCP (no shell only):
hack setup mcp