# Luzia Cheat Sheet

A quick reference for the most commonly used Luzia commands.

## Essential Commands

```bash
luzia --help              # Show help
luzia list                # List projects
luzia status              # Check status
luzia <project> <task>    # Run task
```

## Troubleshooting

```bash
# See what failed
luzia failures

# Show error breakdown
luzia failures --summary

# Retry failed job
luzia retry <job_id>

# Auto-retry all fixable
luzia failures --auto-retry

# Kill stuck job
luzia kill <job_id>
```

## System Maintenance

```bash
# Preview cleanup
luzia cleanup --dry-run

# Clean old jobs
luzia cleanup jobs

# Stop stale containers
luzia cleanup containers

# Full cleanup
luzia cleanup
```

## Project Work

```bash
# Interactive session
luzia work on <project>

# View logs
luzia logs <project>

# View history
luzia history <project>

# Stop container
luzia stop <project>
```

## Knowledge Base

```bash
# Search docs
luzia docs "topic"

# Search sysadmin docs
luzia docs sysadmin "nginx"

# Show entity
luzia docs --show entity_name

# Show stats
luzia docs --stats

# Sync docs
luzia docs --sync
```

## Research

```bash
# Start research
luzia research dss "topic"

# List research
luzia research-list dss

# Show research
luzia research-show session_id

# Show knowledge
luzia research-knowledge dss
```

## Code Analysis

```bash
# Analyze project
luzia structure dss

# Output JSON
luzia structure dss --json

# Analyze subdirectory
luzia structure . lib/
```

## Advanced

```bash
# Deep reasoning
luzia think deep "question"

# Run QA checks
luzia qa

# Sync code to KG
luzia qa --sync

# Raw command
luzia --exec project "command"

# Read file
luzia --read project /path/to/file

# Write file
luzia --write project /path/to/file "content"
```

## Flags

```bash
--help              # Help
--verbose           # Detailed output
--fg                # Run in foreground
```

## Quick Patterns

**Check Everything:**
```bash
luzia list
luzia status
luzia maintenance
```

**Fix Problems:**
```bash
luzia failures --summary
luzia retry <job_id>
# or
luzia failures --auto-retry
```

**Work on Project:**
```bash
luzia work on <project>
# or
luzia <project> <task> [args]
```

**Research Topic:**
```bash
luzia research <project> "your question"
luzia research-show <session_id>
```

**Analyze Code:**
```bash
luzia structure <project> --json
luzia docs "search term"
```

**Clean Up:**
```bash
luzia cleanup --dry-run    # Preview
luzia cleanup              # Execute
```

## Exit Codes

- **0** - Success
- **1** - General error
- **2** - Invalid arguments
- **3** - Project not found
- **4** - Container error

## Project List

View with: `luzia list`

Common projects:
- `musica` - Music processing
- `overbits` - Data systems
- `dss` - Development
- `librechat` - Chat interface
- `admin` - System administration

---

**Full Documentation:** See `LUZIA_COMMAND_REFERENCE.md`