Simplify local dev startup with single ./dev.sh script

[danielmillerp]

Summary

Single ./dev.sh script to start the entire Agentex dev environment. Sits on top of existing Makefiles (delegates to make dev) so no duplication or drift.

Why: Watched people onboard to agentex - having to open 3 terminals and run different commands is friction. This gives a "just make it work" option while keeping the Makefiles for finer control.

What it does:

• Auto-installs missing prereqs (Homebrew, uv, Node, agentex-sdk) on first run
• Starts backend + frontend in background
• Waits for backend health check before declaring ready
• Logs to .dev-logs/ so you can ./dev.sh logs to see everything

Demo

$ ./dev.sh 
[INFO] Checking prerequisites...
[SUCCESS] All prerequisites found

========================================
   Starting Agentex Development Env    
========================================

[INFO] Starting backend services...
[SUCCESS] Backend starting (PID: 44341)
[INFO] Starting frontend...
[SUCCESS] Frontend starting (PID: 44342)

[INFO] Waiting for backend to be healthy...
..........[SUCCESS] Backend is healthy!

[SUCCESS] Development environment is ready!
[INFO] Open http://localhost:3000 to access the UI

$ ./dev.sh stop
[INFO] Stopping all services...
[SUCCESS] All services stopped

Commands

Command	Description
./dev.sh	Start everything
./dev.sh stop	Stop everything
./dev.sh status	Check what's running
./dev.sh logs	Tail all logs
./dev.sh restart	Stop + start

🤖 Generated with Claude Code

[prassanna-ravishankar]

This seems largely overlapping with the makefiles in the various folders? Perhaps we can remove all of them and just have a root justfile ?

Will keep things consistent and avoid implementation drift.

[danielmillerp]

This seems largely overlapping with the makefiles in the various folders? Perhaps we can remove all of them and just have a root justfile ?

Will keep things consistent and avoid implementation drift.

Changed it so dev.sh calls the Makefiles now instead of reimplementing the docker compose / npm stuff. So no
drift - it just delegates.

Want to keep the Makefiles since people use them directly. This is meant to sit higher up as a "make it work"
for folks onboarding to agentex, vs the Makefiles give finer control if you know what you're doing.