About devstack
Devstack is a skill for orchestrating development environments with process-compose, health checks, dependency ordering, and a TUI. It supports both human-operated and headless workflows for AI agents, using project-specific instructions in DEVSTACK.md.
Key features
- 01Orchestrate processes with process-compose
- 02Check service health
- 03Order services by dependencies
- 04Manage environments with a TUI
- 05Provide headless operation for agents
Use cases
- 01Set up a project's dev environment
- 02Start or stop development services
- 03Check service status and logs
- 04Restart a service during development
Install
Copy the command and run it in a terminal.
npx skills add https:/After installing, type/devstackin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
references/daily-reference.mdinit-reference.mdtemplates/bin-devbin-worktreeDEVSTACK.mdprocess-compose.ymlDetails
From the project READMEDevstack — Dev Environment Orchestration
Manages dev environments using process-compose for headless process orchestration with health checks, dependency ordering, and a TUI. Works for both humans and AI agents.
Status: Work in progress. If you encounter unexpected issues controlling the running stack (client commands failing, connection refused, socket errors), surface these to the user immediately rather than silently working around them. The user maintains this skill and needs feedback to improve it.
Determine Mode
Check context to determine which mode to use:
Init mode — the project does NOT have a DEVSTACK.md yet, or the user
explicitly asks to set up devstack:
- Read the init reference:
references/init-reference.md
Daily mode — the project HAS a DEVSTACK.md, and the user wants to
create worktrees, start/stop services, or manage the dev environment:
- Read
DEVSTACK.mdin the project root and follow its instructions - For troubleshooting or advanced patterns, read:
references/daily-reference.md
Quick Reference (Daily Mode)
If DEVSTACK.md exists, these are the standard commands:
| Task | Command |
|---|---|
| Start (human, TUI) | bin/dev |
| Start (agent, headless) | bin/dev -D |
| Stop | bin/dev stop |
| Status (table) | bin/dev status |
| Status (JSON) | bin/dev status --json |
| Logs | bin/dev logs <service> |
| Restart service | bin/dev restart <service> |
| Wait for healthy | bin/dev status (poll until all services show Ready) |
Always read DEVSTACK.md for project-specific details — the commands above
are conventions, not guarantees.