Skip to content

README.md

Latest commit

 

History

History
92 lines (66 loc) · 1.79 KB

README.md

File metadata and controls

92 lines (66 loc) · 1.79 KB

TinyOffice

Web portal for TinyClaw. TinyOffice provides a browser UI for monitoring and operating your agent system.

Features

  • Real-time dashboard (agents, teams, queue, event feed)
  • Web chat console with @agent / @team routing
  • Agent management (create, edit, delete)
  • Team management (members + leader)
  • Task board (kanban + drag/drop + assign to agents/teams)
  • Logs and live events view
  • Settings editor for .tinyclaw/settings.json
  • Office simulation view of agent/team interactions

Requirements

  • Node.js 18+
  • Running TinyClaw backend/API (default: http://localhost:3777)

Setup

cd tinyoffice
npm install

Configuration

TinyOffice reads the backend base URL from NEXT_PUBLIC_API_URL.

Default:

  • http://localhost:3777

If needed, create tinyoffice/.env.local:

NEXT_PUBLIC_API_URL=http://localhost:3777

Run

Development:

npm run dev

Open http://localhost:3000.

Production:

npm run build
npm run start

Scripts

  • npm run dev - Start Next.js dev server
  • npm run build - Build production bundle
  • npm run start - Start production server
  • npm run lint - Run ESLint

API Endpoints Used

TinyOffice calls TinyClaw API endpoints such as:

  • POST /api/message
  • GET /api/agents
  • PUT /api/agents/:id
  • DELETE /api/agents/:id
  • GET /api/teams
  • PUT /api/teams/:id
  • DELETE /api/teams/:id
  • GET /api/tasks
  • POST /api/tasks
  • PUT /api/tasks/:id
  • PUT /api/tasks/reorder
  • DELETE /api/tasks/:id
  • GET /api/settings
  • PUT /api/settings
  • GET /api/queue/status
  • GET /api/responses
  • GET /api/logs
  • GET /api/events/stream (SSE)

Notes

  • TinyOffice is UI-only; it does not replace TinyClaw daemon processes.
  • Start TinyClaw first so queue processor, channels, and API are available.