Files

admin ec33ac1936 Refactor cockpit to use DockerTmuxController pattern

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>

2026-01-14 10:42:16 -03:00

2.8 KiB

Raw Permalink Blame History

Luzia Cheat Sheet

A quick reference for the most commonly used Luzia commands.

Essential Commands

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

Troubleshooting

# 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

# Preview cleanup
luzia cleanup --dry-run

# Clean old jobs
luzia cleanup jobs

# Stop stale containers
luzia cleanup containers

# Full cleanup
luzia cleanup

Project Work

# Interactive session
luzia work on <project>

# View logs
luzia logs <project>

# View history
luzia history <project>

# Stop container
luzia stop <project>

Knowledge Base

# 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

# 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

# Analyze project
luzia structure dss

# Output JSON
luzia structure dss --json

# Analyze subdirectory
luzia structure . lib/

Advanced

# 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

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

Quick Patterns

Check Everything:

luzia list
luzia status
luzia maintenance

Fix Problems:

luzia failures --summary
luzia retry <job_id>
# or
luzia failures --auto-retry

Work on Project:

luzia work on <project>
# or
luzia <project> <task> [args]

Research Topic:

luzia research <project> "your question"
luzia research-show <session_id>

Analyze Code:

luzia structure <project> --json
luzia docs "search term"

Clean Up:

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

2.8 KiB Raw Permalink Blame History