# Agent Studio

> Develop, run, and debug the AGENT-Studio repo (Next.js frontend + FastAPI backend). Use for repo onboarding, starting/stopping services (restart.sh, ports 3115/8000), env vars, logs, and common dev workflows. 本仓库开发/排障：启动前后端、端口/日志、环境变量、lint/build、定位关键目录。

- Skill: `majiayu000/agent-studio` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/agent-studio`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/agent-studio/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/agent-studio

---


# 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`.