How do I install the Logrefer skill?

Run npx skillmds@latest add takazudo/logrefer in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Logrefer safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Logrefer?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Logrefer free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Logrefer?

takazudo (@takazudo) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Logrefer by takazudo — Agent Skill

Name: Logrefer
Author: takazudo

Logrefer

Browse and read recent logs and artifacts from $HOME/cclogs/{slug}/. Use when: (1) User wants to see recent agent logs, (2) User says 'logrefer', 'show logs', 'recent logs', (3) User wants to read a specific log file from a previous session.

takazudo 1ff1a61 2.4 KB Updated Sep 17, 2026

File contents

Log Browser

Browse and read recent logs and artifacts from the centralized log directory ($HOME/cclogs/{slug}/).

Determine Log Directory

Get the log directory for the current project:

LOGDIR=$(node $HOME/.claude/scripts/get-logdir.js)

If the directory does not exist, inform the user that no logs have been saved yet for this project.

Argument Handling

Check $ARGUMENTS for these patterns:

No arguments: List 10 most recent files with filename and first heading
A number (e.g., 20): List that many most recent files
A prefix string (e.g., reviewer, research, frontend-dev, wt-child, youtube): Filter files by that prefix pattern
read <filename>: Read and display the full content of the specified file

Workflow

Listing Files

Run ls -t "$LOGDIR" to get files sorted by modification time (newest first)
Limit to N files (default 10)
If a prefix filter is given, filter with ls -t "$LOGDIR" | grep "<prefix>"
For each file, extract the first markdown heading (grep -m1 '^#' "$LOGDIR/<file>")
Display as a formatted list: filename -- heading

Reading a File

Match the filename argument against files in $LOGDIR
Use the Read tool to display the full file content
If the filename is ambiguous (partial match), show matching files and ask the user to clarify

Output Format

List Mode

Recent logs in $HOME/cclogs/{slug}/:

  0314_1530-reviewer-auth-refactor.md -- Auth Module Code Review
  0314_1200-research-caching-strategies.md -- Caching Strategy Analysis
  0313_0900-frontend-dev-dashboard.md -- Dashboard Component Implementation
  ...

Read Mode

Display the full file content using the Read tool.

Notes

If $LOGDIR doesn't exist or is empty, inform the user that no logs have been saved yet for this project
The log directory is project-specific: detected from the git repository root basename
Worktrees share the same log directory as their main repository
Numbered sibling copies of a repo share one log directory: a trailing number on the folder name is folded off, so zzmod and zzmod2 both resolve to cclogs/zzmod/

---name: logreferdescription: Browse and read recent logs and artifacts from $HOME/cclogs/{slug}/. Use when: (1) User wants to see recent agent logs, (2) User says 'logrefer', 'show logs', 'recent logs', (3) User wants to read a specific log file from a previous session.---# Log BrowserBrowse and read recent logs and artifacts from the centralized log directory (`$HOME/cclogs/{slug}/`).## Determine Log DirectoryGet the log directory for the current project:```bashLOGDIR=$(node $HOME/.claude/scripts/get-logdir.js)```If the directory does not exist, inform the user that no logs have been saved yet for this project.## Argument HandlingCheck `$ARGUMENTS` for these patterns:- **No arguments**: List 10 most recent files with filename and first heading- **A number (e.g., `20`)**: List that many most recent files- **A prefix string (e.g., `reviewer`, `research`, `frontend-dev`, `wt-child`, `youtube`)**: Filter files by that prefix pattern- **`read <filename>`**: Read and display the full content of the specified file## Workflow### Listing Files1. Run `ls -t "$LOGDIR"` to get files sorted by modification time (newest first)2. Limit to N files (default 10)3. If a prefix filter is given, filter with `ls -t "$LOGDIR" | grep "<prefix>"`4. For each file, extract the first markdown heading (`grep -m1 '^#' "$LOGDIR/<file>"`)5. Display as a formatted list: `filename -- heading`### Reading a File1. Match the filename argument against files in `$LOGDIR`2. Use the Read tool to display the full file content3. If the filename is ambiguous (partial match), show matching files and ask the user to clarify## Output Format### List Mode```Recent logs in $HOME/cclogs/{slug}/: 0314_1530-reviewer-auth-refactor.md -- Auth Module Code Review 0314_1200-research-caching-strategies.md -- Caching Strategy Analysis 0313_0900-frontend-dev-dashboard.md -- Dashboard Component Implementation ...```### Read ModeDisplay the full file content using the Read tool.## Notes- If `$LOGDIR` doesn't exist or is empty, inform the user that no logs have been saved yet for this project- The log directory is project-specific: detected from the git repository root basename- Worktrees share the same log directory as their main repository- Numbered sibling copies of a repo share one log directory: a trailing number on the folder name is folded off, so `zzmod` and `zzmod2` both resolve to `cclogs/zzmod/`

Frequently asked questions