# setup-agent-tail

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.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 1357 repo stars
- Author: qdhenry
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/qdhenry/Claude-Command-Suite/tree/HEAD/.claude/skills/setup-agent-tail/SKILL.md
- Updated: 2026-03-01
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/setup-agent-tail

## What it 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.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add qdhenry/Claude-Command-Suite --skill setup-agent-tail -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/setup-agent-tail/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/setup-agent-tail/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add qdhenry/Claude-Command-Suite --skill setup-agent-tail -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/setup-agent-tail/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add qdhenry/Claude-Command-Suite --skill setup-agent-tail -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/setup-agent-tail/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install qdhenry/Claude-Command-Suite .claude/skills/setup-agent-tail
```

2. **Manually: put the files in place**
- File: `.github/skills/setup-agent-tail/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add qdhenry/Claude-Command-Suite --skill setup-agent-tail -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/qdhenry/Claude-Command-Suite --path .claude/skills/setup-agent-tail
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/setup-agent-tail/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/qdhenry/Claude-Command-Suite/tree/HEAD/.claude/skills/setup-agent-tail/SKILL.md

## When to use it
- 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
- Set up agent-tail for this project
- Deploy log collection from dev server and browser
- Add agent-tail and filter HMR messages

## Similar
- [finding-dev-server-url](https://affpapa.org/en/nevibecode/skills/finding-dev-server-url.md) — skill · 465 installs
- [lingui-framework-setup](https://affpapa.org/en/nevibecode/skills/lingui-framework-setup.md) — skill · 159 installs
- [tail-events](https://affpapa.org/en/nevibecode/commands/tail-events.md) — command · ★ 1198 repo stars
- [nextjs-on-cloudflare](https://affpapa.org/en/nevibecode/skills/nextjs-on-cloudflare.md) — skill · 60100 installs
- [monorepo-setup](https://affpapa.org/en/nevibecode/skills/monorepo-setup.md) — skill · 283 installs
- [monorepo](https://affpapa.org/en/nevibecode/skills/monorepo.md) — skill · 741 installs

From the same set: [qdhenry/claude-command-suite](https://affpapa.org/en/nevibecode/by/qdhenry/claude-command-suite.md) — 112 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
