Overview The lua logs command provides an interactive interface for viewing and navigating your agent’s execution logs with powerful filtering capabilities.
Filter by Type Filter logs by Skills, Jobs, Webhooks, Preprocessors, or Postprocessors
See All Your Components View logs for all your components, including dynamically created jobs
Detailed Information See which component generated each log, including names and IDs
Color-Coded Easily spot errors, warnings, and different log types
Log Types ❌ Error
⚠️ Warn
🔍 Debug
ℹ️ Info
▶️ Start/✅ Complete
Execution errors and failures
Tool execution failures
API errors
Invalid configurations
Stack traces for debugging
Color: Red Warnings and potential issues
Performance warnings
Deprecated features
Configuration warnings
Color: Yellow Debug information
Tool inputs/outputs
Function execution status
Detailed operation info
Color: Blue General information
Operation status
Configuration changes
General messages
Color: Cyan Operation metrics
Operation started
Operation completed
Duration measurements
Color: Green Interactive Flow
Choose What to View
📊 Viewing logs for agent: myAgent ? What logs do you want to view? ❯ 📋 All agent logs 🔎 Filter logs
Choose What to Filter (if filtering)
? Filter by: ❯ Skills Jobs Webhooks Preprocessors Postprocessors ────────────────────── 📋 All logs ← Back
Select Specific Component (if filtering)
? Select a job: ❯ All Jobs ────────────────────── Nightly User Report Daily Cleanup Task ────────────────────── ← Back
All Jobs Visible : All your jobs appear in the list, including ones created dynamically in your code.
View Logs
All Agent Logs ──────────────────────────────────────────────────── Page 1 of 88 (872 total logs) ❌ [2/3/2025, 4:40:55 PM] ERROR Job Name: Nightly User Report Job ID: job_abc123 Error executing function: Invalid API Key ────────────────────────────────────────────────── ✅ [2/3/2025, 4:40:55 PM] COMPLETE Skill Name: customer-service Skill ID: skill_def456 Tool Name: search_products Duration: 125ms Execute function completed ──────────────────────────────────────────────────
Navigate
? Navigation: ❯ Next Page → ← Previous Page 🔢 Go to specific page 🔄 Refresh ❌ Exit
Use Cases $ lua logs → Filter logs → Skills → Select your skill → Look for ❌ ERROR entries → Review error messages → Fix issues in your code
$ lua logs → Filter logs → Select component type → Find ✅ COMPLETE entries → Check duration metrics → Identify slow operations
$ lua logs → Filter logs → Skills → Select your skill → Look for 🔍 DEBUG entries → Verify tool inputs/outputs
Track Webhook Activity $ lua logs → Filter logs → Webhooks → Select your webhook → Review webhook execution logs → Check request/response data → Debug external integrations
Monitor Job Execution $ lua logs → Filter logs → Jobs → Select your job → View scheduled job execution logs → Check for errors or performance issues
Example Session $ lua logs ✅ Authenticated 📊 Viewing logs for agent: myAgent ? What logs do you want to view? 🔎 Filter logs ? Filter by: Jobs ? Select a job: Nightly User Report All Agent Logs ──────────────────────────────────────────────────────────────────────────────── Page 1 of 12 (120 total logs ) ▶️ [11/7/2025, 10:30:00 AM] START Job Name: Nightly User Report Job ID: job_abc123 Duration: 150ms Starting job execution... ────────────────────────────────────────────────────────────────────────────── ✅ [11/7/2025, 10:30:05 AM] COMPLETE Job Name: Nightly User Report Job ID: job_abc123 Duration: 5234ms Job execution completed successfully ────────────────────────────────────────────────────────────────────────────── ? Navigation: Next Page → [Shows page 2...]
Filtering by Skill $ lua logs ? What logs do you want to view? 🔎 Filter logs ? Filter by: Skills ? Select a skill: customer-service All Agent Logs ──────────────────────────────────────────────────────────────────────────────── Page 1 of 25 (250 total logs ) ℹ️ [11/7/2025, 10:31:15 AM] INFO Skill Name: customer-service Skill ID: skill_def456 Tool Name: search_products Fetching products matching query... ────────────────────────────────────────────────────────────────────────────── ✅ [11/7/2025, 10:31:16 AM] COMPLETE Skill Name: customer-service Skill ID: skill_def456 Tool Name: search_products Duration: 89ms Found 15 products matching "laptop" ──────────────────────────────────────────────────────────────────────────────
Log Entry Details Each log entry shows you:
For Skill Logs
Skill Name - Which skill generated the logSkill ID - Unique identifier for the skillTool Name - Which tool was running (if applicable)Timestamp - When the log was createdLog Type - Error, debug, info, warn, start, or completeMessage - The actual log messageDuration - How long the operation took (for completed operations)
For Job Logs
Job Name - Which job generated the logJob ID - Unique identifier for the jobTimestamp - When the log was createdLog Type - Error, debug, info, warn, start, or completeMessage - The actual log messageDuration - How long the job took to run
For Webhook, Preprocessor, and Postprocessor Logs
Name - Which component generated the logID - Unique identifierTimestamp - When the log was createdLog Type - Error, debug, info, warn, start, or completeMessage - The actual log messageDuration - How long the operation took
Tool Information : Tool names are only shown for skill logs, since tools belong to skills.
Navigation Options Next Page →
← Previous Page
🔢 Go to specific page
🔄 Refresh
❌ Exit
View the next page of logs Disabled if on last page
Go back to previous page Disabled if on first page
? Enter page number (1-88): 45
Jump directly to any page Reload current page with latest logs Useful for monitoring in real-time
Close the logs viewer
Best Practices
# Get overview first lua logs → All agent logs # Then filter if needed lua logs → Specific skill logs
# After deploying lua push && lua deploy # Monitor logs lua logs → All agent logs → Refresh periodically
# Issue with specific skill lua logs → Specific skill logs → Select problem skill # Focus on errors # Look for ❌ ERROR entries
Troubleshooting
Causes:
Skills not deployed yet
Agent hasn’t been used
Viewing wrong agent
Solution: lua push # Deploy skills lua chat # Use agent to generate logs lua logs # View logs
Can't find specific error
Try:
Navigate through pages using the navigation menu
Filter by the specific component (skill, job, etc.)
Check the most recent pages first (page 1)
Look at the timestamp to find when the error occurred
Use refresh: Reloads current page with latest data Integration with Workflow During Development # Make changes vim src/tools/MyTool.ts # Test lua chat # Check logs immediately lua logs # Look for errors or warnings
After Deployment # Deploy lua push && lua deploy # Monitor logs lua logs # Watch for errors in production # Check performance metrics
Debugging Issues # User reports an issue lua logs # Find the relevant error in the logs # Note the timestamp and which component had the error # Fix the issue in your code # Deploy the fix # Monitor logs again to verify the fix
lua chat Test agent (generates logs)
lua test Test tools locally (no remote logs)
lua push Deploy skills (required for logs)
lua production View production environment
Next Steps 
