ec33ac1936
Based on claude-code-tools TmuxCLIController, this refactor: - Added DockerTmuxController class for robust tmux session management - Implements send_keys() with configurable delay_enter - Implements capture_pane() for output retrieval - Implements wait_for_prompt() for pattern-based completion detection - Implements wait_for_idle() for content-hash-based idle detection - Implements wait_for_shell_prompt() for shell prompt detection Also includes workflow improvements: - Pre-task git snapshot before agent execution - Post-task commit protocol in agent guidelines Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
207 lines
2.8 KiB
Markdown
207 lines
2.8 KiB
Markdown
# 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`
|