machina-docker

Orchestrate Docker containers, health checks, and data volumes for the machina-meta workspace.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/NumberOne-AI/machina-meta --skill machina-docker
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: machina-docker
Source: https://github.com/NumberOne-AI/machina-meta/tree/main/.claude/skills/machina-docker
Command: npx skills add https://github.com/NumberOne-AI/machina-meta --skill machina-docker

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill provides a unified, Docker-based development environment orchestration for the machina-meta workspace, enabling consistent startup, health monitoring, and data-management workflows across multiple services.

Core Features & Use Cases

  • Workspace orchestration: Start, stop, and monitor the full dev stack (frontend, backend, catalogs, databases) with a single command.
  • Health and status automation: Automatic health checks and status reporting for all services, with snapshot-based restoration of critical components like Qdrant embeddings.
  • Volume and data management: Manage persistent data volumes, backups, and restores for PostgreSQL, Neo4j, Redis, and Qdrant, ensuring data continuity across restarts.
  • Developer tooling integration: Integrates with gcloud-admin, gateway tooling, and observability stacks to streamline development workflows.
  • Use Case Example: A developer starts the full stack with one command, validates health, then iterates on backend changes while preserving data.

Quick Start

From the workspace root, run just dev-up to start the full stack, then use just dev-status to verify health, and finally run just dev-down when finished. You can also selectively target services (e.g., just dev-status, just dev-down) as part of daily development rituals.

Frequently Asked Questions about machina-docker

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

FAQPage Schema
How do I orchestrate a full-stack Docker dev environment with one command?

You can orchestrate a Docker dev stack by running a single command from the workspace root to start all services. This unified workflow brings up frontend, backend, catalogs, and databases simultaneously for full-stack development.

Can I manage persistent data volumes for PostgreSQL, Neo4j, Redis, and Qdrant in Docker?

Yes, you can manage persistent data volumes for PostgreSQL, Neo4j, Redis, and Qdrant. The system handles volume backups and restores, ensuring data continuity across container restarts and snapshot-based restoration.

How do I check the health status of my Docker containers during development?

You check Docker container health by running a dedicated status command. This triggers automatic health checks and status reporting for all active services, validating that your full dev stack is operational.

Does Docker Compose support selective service targeting for daily development rituals?

Yes, Docker Compose supports selective service targeting. You can selectively start, check status, or stop specific services as part of your daily development workflow without affecting the entire stack.

What is the best way to preserve Qdrant embeddings data across Docker restarts?

The best way to preserve Qdrant embeddings is through snapshot-based restoration. The system manages persistent data volumes and automated snapshots, ensuring your vector data survives container restarts.