Skip to main content

​
Commands Reference

GAIA uses mise as a unified task runner. Run mise tasks to see all available commands.

​
Quick Start

mise setup        # First time setup
mise dev          # Start development (backend + frontend + docker)
mise dev:full     # Start everything (includes ARQ worker)

​
Root Commands

Run these from the project root.

​
Development

CommandDescription
mise devBackend + frontend + docker logs
mise dev:backendBackend only (no docker)
mise dev:frontendFrontend only
mise dev:arqARQ worker only
mise dev:fullEverything (backend + frontend + ARQ + docker)

​
Setup

CommandDescription
mise setupComplete setup (env check, deps, docker, seed models)
mise setup:envCheck if .env files exist
mise setup:backendBackend dependencies only
mise setup:frontendFrontend dependencies only
mise setup:depsAll dependencies

​
Code Quality

CommandDescription
mise lintLint backend + frontend
mise formatFormat backend + frontend
mise cleanClean build artifacts

​
Documentation

CommandDescription
mise docsRun mintlify docs server

​
Backend Commands

Run from backend/ or use mise -C backend <task> from root.

​
Development

CommandDescription
mise devDev server with hot reload (port 8000)
mise startProduction server
mise workerARQ background worker (alias: arq)

​
Code Quality

CommandDescription
mise lintRuff linter
mise lint:fixAuto-fix lint issues
mise formatFormat with ruff
mise mypyType checking

​
Security & Testing

CommandDescription
mise schemaTest API schema
mise schema:writeTest schema + JUnit report
mise banditSecurity scanner
mise pip:auditAudit package vulnerabilities
mise secretsDetect secrets in code

​
Database

CommandDescription
mise seed:modelsSeed AI models
mise seed:workflowsSeed workflows

​
Maintenance

CommandDescription
mise installInstall dependencies (uv)
mise cleanClean __pycache__ and .pyc

​
Frontend Commands

Run from frontend/ or use mise -C frontend <task> from root.

​
Development

CommandDescription
mise devDev server with Turbopack (port 3000)
mise dev:webpackDev server with Webpack
mise buildProduction build
mise startProduction server

​
Code Quality

CommandDescription
mise typeTypeScript type checking
mise lintESLint
mise lint:fixAuto-fix lint issues
mise lint:exportExport ESLint config
mise formatFormat with Prettier

​
Dependencies

CommandDescription
mise installInstall with pnpm
mise depcheckCheck unused dependencies
mise knipFind unused files/exports

​
Build & Analysis

CommandDescription
mise analyzeBundle size analysis
mise generate:barrelsGenerate barrel exports

​
Maintenance

CommandDescription
mise cleanClean .next, node_modules, .turbo
mise clean:cacheClean .next only
mise prepareSetup git hooks (husky)

​
Docker Commands

Standard Docker Compose commands:
CommandDescription
docker compose upStart services
docker compose up -dStart in background
docker compose downStop and remove
docker compose logs -fStream logs
docker compose logs -f postgresLogs for specific service
docker compose restartRestart services
docker compose buildRebuild images
docker compose --profile all upAll containers (backend/arq)
docker compose --profile backend upServices + backend
docker compose --profile worker upServices + ARQ worker

​
Tips

Run tasks from anywhere: 
mise -C backend dev           # Backend from root
mise -C frontend lint         # Frontend from root
Common workflows: 
mise setup                    # First time
mise dev                      # Daily dev
mise dev:full                 # Everything
mise lint && mise format      # Code quality
Need help?
  1. Check you’re in the correct directory
  2. Run mise setup to install dependencies
  3. Verify Docker is running
  4. Check .env files exist
  5. See Development Setup