# Logs Tool

> LOAD THIS SKILL when: reading application logs, listing log files, or accessing remote pod logs. Contains all logs-tool commands.

- Skill: `blogic-cz/logs-tool` (Agent Skill)
- Install (CLI): `npx skillmds@latest add blogic-cz/logs-tool`
- Raw SKILL.md: https://api.skillmd.com/api/skills/blogic-cz/logs-tool/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: blogic-cz (https://skillmd.com/u/blogic-cz)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/blogic-cz/logs-tool

---


# logs-tool (Application Logs)

Application logs — read local and remote (k8s pod) logs. Part of [@blogic-cz/agent-tools](https://github.com/blogic-cz/agent-tools).

## How to Run

Run via `bun logs-tool` (requires `@blogic-cz/agent-tools` as a dev dependency).
Auth: no auth needed for local files; uses k8s-tool for remote access.

## Commands

```bash
bun logs-tool list --env local          # List available log files
bun logs-tool read --env local --file app.log  # Read specific log
bun logs-tool read --env test --file app.log --tail 50
bun logs-tool read --env test --file app.log --grep "connection refused"
```

`--grep` uses the same case-insensitive literal substring match for local and remote logs; it is not a regular expression. File paths are confined to the configured local or remote log directory. Treat configured log directories as trusted: workloads must not replace checked files or ancestors with symlinks during a read.

Environment is any string (e.g. `local`, `test`). Set `defaultEnvironment` in `agent-tools.json5` to skip `--env` on every call.

## Tips

- Use `bun logs-tool commands` for the full machine-readable command/flag tree; `--help` for one subcommand.
- Output defaults to **TOON** (token-efficient) — leave it as-is to save tokens. Add `--format json` only when you'll machine-parse the result.
- Error responses include `hint`, `nextCommand`, and `retryable` fields — always check them on failure.