quixotic/.serena/memories/suggested_commands.md

Suggested Commands for Quixotic Development

Development Commands

• yarn install - Install project dependencies
• yarn dev - Start development server with nodemon (auto-restart)
• yarn start - Start production server

System Requirements

• FFmpeg Installation:
  • macOS: brew install ffmpeg
  • Ubuntu/Debian: sudo apt install ffmpeg
  • Windows: Download from ffmpeg.org

Environment Setup

• cp .env.example .env - Create environment configuration file
• Edit .env file with required values:
  • TELEGRAM_BOT_TOKEN=your_bot_token_here
  • WEB_APP_URL=https://your-domain.com
  • PORT=3000

Git Commands (Darwin System)

• git status - Check repository status
• git add . - Stage all changes
• git commit -m "message" - Commit changes
• git push - Push to remote repository

File System Commands (macOS/Darwin)

• ls -la - List files with details
• find . -name "*.js" - Find JavaScript files
• grep -r "text" . - Search for text in files
• cd directory - Change directory
• mkdir directory - Create directory
• rm -rf directory - Remove directory recursively

Database Management

• SQLite database files are in database/ directory
• No dedicated database management commands configured
• Database is automatically initialized on first run

Process Management (Production)

• pm2 start src/server.js --name quixotic - Start with PM2
• pm2 logs quixotic - View logs
• pm2 restart quixotic - Restart application
• pm2 stop quixotic - Stop application

Health Check

• Visit http://localhost:3000/health - Check if server is running
• Check server logs for errors

Port Information

• Default port: 3000 (configurable via PORT environment variable)
• Development server runs on same port as production