hack-cli

Orchestrate Docker Compose lifecycles with Caddy-hosted HTTPS hostnames and Loki/Grafana logging.

8|2|Updated Dec 29, 2025
One-click install
npx skills add https://github.com/hack-dance/hack --skill hack-cli
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hack-cli
Source: https://github.com/hack-dance/hack/tree/main/.codex/skills/hack-cli
Command: npx skills add https://github.com/hack-dance/hack --skill hack-cli

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill streamlines local development by managing multiple projects simultaneously, preventing port conflicts, and providing stable hostnames and integrated logging.

Core Features & Use Cases

  • Local Runtime Orchestration: Manages Docker Compose for multiple projects, ensuring network isolation.
  • Stable Hostnames & TLS: Provides *.hack hostnames with internal TLS via Caddy proxy.
  • Integrated Logging: Offers docker compose logs tailing and Loki/Grafana for querying.
  • Agent Setup: Facilitates the setup and management of AI agent integrations.
  • Use Case: Run two different projects, each with its own database and API, on your local machine without any port clashes, accessing them via projectA.hack and projectB.hack.

Quick Start

Use the hack CLI to start your project services in detached mode.

Frequently Asked Questions about hack-cli

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run multiple local development environments without port conflicts?

You can run multiple local development environments without port conflicts by orchestrating Docker Compose lifecycles with network isolation, ensuring each project operates independently on your local machine.

How does Caddy provide stable HTTPS hostnames for local Docker Compose projects?

Caddy provides stable HTTPS hostnames for local Docker Compose projects by acting as an internal TLS proxy, routing traffic to assigned domains like `*.hack` for secure local access.

Do I need Docker and Orbstack to orchestrate local dev environments?

Yes, you need Docker, Compose, and Orbstack or Docker Desktop installed to operate the orchestration of local dev environments and manage the required container lifecycles.

What is the best way to manage integrated logging for multiple local Docker projects?

The best way to manage integrated logging for multiple local Docker projects is to tail `docker compose logs` and query aggregated logs using integrated Loki and Grafana services.

Can I facilitate AI agent setup within my local development environment orchestration?

Yes, you can facilitate AI agent setup within your local development environment orchestration, allowing integrated management of AI agents alongside your containerized project services.

Why are my two local projects experiencing database port clashes on the same machine?

Local projects experience database port clashes because they lack network isolation; managing Docker Compose lifecycles with isolated networks prevents these conflicts across simultaneous projects.