setup-agent-tail — Claude Code skill: log setup automation
setup-agent-tail is a Claude Code skill that deploys agent-tail in a project, detects its framework, installs the CLI and plugins, and routes server and browser logs to files for an agent.
no license ★ 1,357 updated 2026-03-01
npx skills add qdhenry/Claude-Command-Suite --skill setup-agent-tail -a claude-codeWhat setup-agent-tail does
Skill reads package.json, vite.config, next.config and monorepo markers, identifies project type and proposes agent-tail configuration. After confirmation it installs agent-tail-core (the agent-tail umbrella package has a broken bin field that prevents CLI linking), sets up the Vite or Next.js plugin, wraps scripts with agent-tail-core run and adds tmp/ to .gitignore. Logs land in tmp/logs/latest/.
For Vite and Next.js the skill configures capture of console.* and unhandled errors from the browser. Without the plugin only server logs reach the files. In monorepos you need agent-tail-core init at root before turbo dev, or child packages won't join the session. Skill asks which services to wrap, where to send output, and whether to filter [HMR] and other noisy lines.
What it helps with
- deploy unified log collection for frontend and backend
- set up agent-tail for Vite, Next.js or monorepo
- filter noisy messages like
[HMR]and[Fast Refresh] - pipe browser console to a file for agent consumption
Example prompts for the agent
- Set up agent-tail for this project
- Deploy log collection from dev server and browser
- Add agent-tail and filter HMR messages
How to install setup-agent-tail
1Skills CLI (Vercel)
npx skills add qdhenry/Claude-Command-Suite --skill setup-agent-tail -a claude-code2Manually: put the files in place
~/.claude/skills/setup-agent-tail/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/setup-agent-tail/
1Skills CLI (Vercel)
npx skills add qdhenry/Claude-Command-Suite --skill setup-agent-tail -a codex2Manually: put the files in place
.agents/skills/setup-agent-tail/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add qdhenry/Claude-Command-Suite --skill setup-agent-tail -a cursor2Manually: put the files in place
.cursor/skills/setup-agent-tail/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install qdhenry/Claude-Command-Suite .claude/skills/setup-agent-tail2Manually: put the files in place
.github/skills/setup-agent-tail/SKILL.md1Skills CLI (Vercel)
npx skills add qdhenry/Claude-Command-Suite --skill setup-agent-tail -a gemini-cli2Platform CLI
gemini skills install https://github.com/qdhenry/Claude-Command-Suite --path .claude/skills/setup-agent-tailManually: put the files in place
.devin/skills/setup-agent-tail/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about setup-agent-tail
How to install setup-agent-tail in Claude Code?
Run npx skills add qdhenry/Claude-Command-Suite --skill setup-agent-tail -a claude-code, then open ~/.claude/skills/setup-agent-tail/SKILL.md in project context.
What does setup-agent-tail skill do?
Detects project type, installs agent-tail-core, configures plugins for Vite or Next.js, wraps dev scripts and directs server and browser logs to tmp/logs/latest/ for agent consumption.
Why install agent-tail-core separately?
The agent-tail umbrella package has a broken bin field, so package managers don't link the CLI. Installing agent-tail-core provides the working agent-tail-core command for scripts.