Agent Studio (Repo)

Navigate the repo

• Run ./restart.sh to start the full stack (kills ports 8000/3115, starts FastAPI, then Next dev on 3115).
• Find frontend entry points in src/app/ and shared UI in src/components/.
• Find chat API in src/app/api/chat/route.ts.
• Find backend API in backend/main.py and game engine code in backend/engine/.
• Read architectural notes before large refactors:
  • docs/dev_docs/2025-12-31-chat-architecture-refactor.md
  • docs/dev_docs/2025-12-31-game-playground-roadmap.md
  • docs/refactoring_docs/2026-01-01-playground-page-refactor.md

Run common workflows

• Start frontend only: npm install then npm run dev -- -p 3115.
• Start backend only: cd backend && (source .venv/bin/activate || true) && python main.py.
• Lint/build: npm run lint, npm run build.

Check configuration quickly

• Set OPENROUTER_API_KEY in .env.local for chat (src/app/api/chat/route.ts).
• Verify backend health at http://localhost:8000/health.
• Tail backend logs at backend/backend.log when using ./restart.sh.