Logs
npx machina-cli add skill Speedy0000007/claude-tandem/logs --openclawTandem Logs
Read and display entries from ~/.tandem/logs/tandem.log.
Subcommands
Parse $ARGUMENTS to determine the mode:
- No arguments (or empty): Show the last 20 log entries.
errors: Filter to only[ERROR]and[WARN ]entries, show last 50.- A number (e.g.,
50): Show the last N entries. clear: Ask the user to confirm, then truncate the log file (> ~/.tandem/logs/tandem.log).
Output format
Display the log entries in a code block. Each entry follows this format:
2026-02-12 10:30:45 [INFO ] [session-start] provisioned rules files
After the entries, show:
- Current log level:
TANDEM_LOG_LEVELenv var (default:info) - Tip: "Set
TANDEM_LOG_LEVEL=debugfor verbose output" (if not already debug)
If log file doesn't exist
Report: "No log file found at ~/.tandem/logs/tandem.log. Tandem logs are created on first hook execution."
Source
git clone https://github.com/Speedy0000007/claude-tandem/blob/main/plugins/tandem/skills/logs/SKILL.mdView on GitHub Overview
This skill reads and displays entries from ~/.tandem/logs/tandem.log. It supports showing recent activity, filtering errors, selecting a range, and clearing the log when needed. Use it to debug hook behavior and understand what happened.
How This Skill Works
ARGUMENTS specify the mode: no args shows the last 20 entries, errors filters to [ERROR] and [WARN] with the last 50, a number shows the last N entries, and clear truncates after confirmation. Entries are displayed in a code block with timestamps, followed by the current TANDEM_LOG_LEVEL (default: info) and a tip to enable debug for verbose output. If no log file exists, you’ll see a message that no log file was found and that logs are created on first hook execution.
When to Use It
- You want to review the most recent Tandem activity.
- You mention 'tandem logs', 'what happened', or 'tandem errors'.
- You need to filter only errors and warnings.
- You want to view a specific number of recent log entries.
- You need to clear the log after debugging and confirm before truncation.
Quick Start
- Step 1: Run the command with no arguments to view the last 20 log entries.
- Step 2: Run with 'errors' to filter [ERROR] and [WARN] and show the last 50.
- Step 3: Run with a number like '50' or 'clear' to truncate after confirmation.
Best Practices
- Be explicit about the mode you want (no args, errors, a number, or clear).
- When clearing, always confirm to prevent accidental data loss.
- Check the timestamp format to correlate events across sessions.
- If troubleshooting, temporarily set TANDEM_LOG_LEVEL=debug for more detail.
- If the log file is missing, rely on the no-log message and hook creation guidance.
Example Use Cases
- Show the last 20 Tandem log entries with no arguments.
- Filter to only errors and warnings and view the last 50.
- Display the last 100 entries using a numeric argument.
- Clear the log after a debugging session with confirmation.
- Receive a 'no log file found' notice until first hook execution.
