devstack
Devstack — 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 (March 2026). 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.
More from steveclarke/dotfiles
md-to-pdf
Convert markdown files to PDF using Chrome. Use when user wants to render markdown to PDF, print a document, or create a shareable PDF from markdown. Triggers on "markdown to pdf", "render to pdf", "pdf from markdown", "print this markdown".
75bruno-endpoint-creation
Create Bruno REST API endpoint configurations with proper authentication, environment setup, and documentation. Use when setting up API testing with Bruno, creating new endpoints, or configuring collection-level authentication. Triggers on "create Bruno endpoint", "Bruno API testing", "set up Bruno collection".
68readme-writer
Write and revise READMEs and technical documentation for software projects. Scores readability with Flesch-Kincaid and vocabulary profiling. Use when writing, revising, or reviewing a README, README.md, or project documentation. Triggers on "write readme", "improve readme", "readme review", "documentation writing".
56time-tracking
Manage time tracking with Toggl or Clockify. Use when user asks about time tracking, timers, timesheets, logging hours, starting/stopping work, checking what's running, viewing time entries, or creating manual entries. Triggers on "toggl", "clockify", "time tracking", "timer", "timesheet", "log time", "track time", "hours worked".
52feature-spec
Creates concise technical specification documents through guided architectural decisions, system contracts, and technical design. Produces a spec.md covering API design, data models, frontend architecture, and integration points without implementation details.
491password
Fetch secrets and create/manage 1Password items via CLI. Use when needing API keys, tokens, or credentials, or when storing new secrets. Ask user for the 1Password secret reference (op://Vault/Item/field format) rather than the actual secret.
49