# BMAD Task Manager - Suggested Commands

## Development Commands

### Starting the Application
```bash
# Start everything with auto-browser launch (Serena-style)
./bmad

# Start MCP server only (for Claude/GPT integration)
./bmad mcp

# Start API server and Web UI separately
cd server && npm run dev:web  # API on port 7531
cd web && npm run dev          # UI on port 7530

# Stop all services
./stop.sh
```

### Building
```bash
# Build both server and client
npm run build

# Build server only
cd server && npm run build

# Build web UI only
cd web && npm run build
```

### Testing
```bash
# Run all tests
npm test

# Server tests
cd server && npm test

# Web tests
cd web && npm test
```

### Linting
```bash
# Web linting
cd web && npm run lint
```

### Installation
```bash
# Install all dependencies
npm run install:all

# Or manually
npm install
cd server && npm install
cd ../web && npm install
```

## Environment Configuration
```bash
# Use custom ports
API_PORT=8531 WEB_PORT=8530 ./bmad

# Or set in .env file
echo "API_PORT=8531" >> .env
echo "WEB_PORT=8530" >> .env
```

## MCP Mode Commands
```bash
# Start MCP server for LLM integration
RUN_MODE=stdio node server/dist/index.js

# Or use the script
./bmad mcp
```

## System Commands (macOS/Darwin)
```bash
# Check port usage
lsof -i :7531

# Kill process on port
lsof -ti :7531 | xargs kill -9

# Find processes
pgrep -f "bmad-task-manager"

# Git operations
git add .
git commit -m "message"
git status
git diff

# File operations
ls -la
find . -name "*.ts"
grep -r "pattern" .
```