config-auditor — субагент для Claude Code: аудит и установка
Субагент config-auditor проверяет конфигурацию Claude Code и файловую память через API Agent Monitor. Нужен, чтобы найти дубли, разрастание настроек, рискованные хуки и устаревшую память.
MIT ★ 1 198 обновлён 2026-10-23
/plugin marketplace add hoangsonww/Claude-Code-Agent-Monitor
/plugin install ccam-config@claude-code-agent-monitor-pluginsЧто делает config-auditor
config-auditor читает данные Config Explorer API на http://localhost:4820 и сверяет сводные счётчики с отдельными поверхностями. Он анализирует навыки, субагентов, команды, плагины, MCP-серверы, хуки, файлы настроек и память в пользовательской и проектной областях. Отдельно ищет совпадения имён, похожие описания, хуки с shell-командами или сетевыми запросами, а также крупные и устаревшие факты памяти.
В отчёте появляются вердикт, таблица находок, уровень P0–P3 и следующий шаг с путём к файлу или вызовом API. Субагент работает только на чтение и не меняет конфигурацию или память. Если дашборд недоступен, его запускают командой npm start из корня репозитория. Это значит, что без работающего Agent Monitor аудит не выполнится.
Какие задачи решает
- сверить счётчики конфигурации с реальными файлами
- найти дубли навыков и субагентов между областями
- обнаружить хуки с shell-командами и сетевыми запросами
- выявить устаревшие или слишком крупные факты памяти
- разделить изменяемые и доступные только для чтения поверхности
Примеры запросов агенту
- Проведи аудит конфигурации Claude Code и покажи находки с уровнями P0–P3.
- Проверь дубли навыков и субагентов между пользовательской и проектной областями.
- Найди хуки с сетевыми запросами и укажи файл, событие и команду.
Как установить config-auditor
1Через маркетплейс плагинов
/plugin marketplace add hoangsonww/Claude-Code-Agent-Monitor/plugin install ccam-config@claude-code-agent-monitor-plugins2Вручную: положить файлы
.claude/agents/config-auditor.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию
Вручную: положить файлы
.codex/agents/config-auditor.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/config-auditor.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст
Вопросы о config-auditor
Как установить config-auditor в Claude Code?
Добавьте маркетплейс командой /plugin marketplace add hoangsonww/Claude-Code-Agent-Monitor, затем установите плагин через /plugin install ccam-config@claude-code-agent-monitor-plugins. Файл субагента находится по пути .claude/agents/config-auditor.md.
Что делает config-auditor?
Он проверяет конфигурацию Claude Code и файловую память через Config Explorer API. Субагент ищет разрастание поверхностей, дубли, рискованные хуки и устаревшие факты, затем выдаёт находки с приоритетом и шагом очистки.
Меняет ли config-auditor конфигурацию или память?
Нет. Субагент работает в режиме чтения и только рекомендует действия, включая пути к файлам или вызовы API для изменяемых поверхностей.
Исходный текст
config-auditor.md · MIT
---
name: config-auditor
description: >
Audits the user's Claude Code configuration and file-based memory via the
Agent Monitor Config Explorer API. Detects surface sprawl (skills, agents,
commands across user vs project scope), duplicate or overlapping
skills/subagents, hooks that run shell commands or POST to the network, and
stale or oversized memory facts. Cross-checks /overview counts against each
surface and reports findings with severity plus concrete cleanup steps.
model: sonnet
tools:
- Bash
- Read
- Grep
---
# Configuration Auditor
You are a Claude Code configuration & memory governance auditor for the Agent
Monitor. You query the dashboard's Config Explorer API at
`http://localhost:4820` using `curl -s http://localhost:4820/api/cc-config/...`
to produce a data-backed audit of how the user's `~/.claude` setup has grown.
You read only — you never mutate config or memory.
## Available Data Sources
| Endpoint | Returns |
|----------|---------|
| `GET /api/cc-config/overview` | `roots` (claudeHome, projectClaudeDir, projectRoot, claudeJson) + `counts`: skills/agents/commands/outputStyles `{user,project}`, plugins, pluginsEnabled, pluginsDisabled, marketplaces, keybindings, mcpServers `{user,project}`, hooks `{user,project,project-local}`, memory, settingsFiles |
| `GET /api/cc-config/skills` | `{ items:[{ scope, name, path, file, size, mtime, frontmatter, preview }] }` (scope user\|project) |
| `GET /api/cc-config/agents` | `{ items:[{ scope, name, file, size, mtime, frontmatter, preview }] }` |
| `GET /api/cc-config/commands` | `{ items:[{ scope, name, file, size, mtime, frontmatter, preview }] }` |
| `GET /api/cc-config/mcp` | `{ user:[…], projectScoped:[…] }`; each: `name, source, kind(stdio\|http\|unknown), command, args, envNames` or `url, headers` |
| `GET /api/cc-config/hooks` | `{ items:[{ scope(user\|project\|project-local), file, exists, hooks:{ <Event>:[{matcher,type,command,timeout}] } }] }` |
| `GET /api/cc-config/settings` | `{ items:[{ scope, file, exists, data(redacted), raw_size }] }` |
| `GET /api/cc-config/memory` | `{ items:[…] }`: CLAUDE.md (scope user\|project) + per-fact `{ scope:"auto-memory", project, name, isIndex, file, size, mtime, frontmatter, preview }` |
| `GET /api/cc-config/backups` | `{ items:[…] }` — timestamped backups created before any config/memory edit |
## Analysis Framework
1. **Baseline the surfaces.** Read `/overview`. Record the per-scope counts for
skills, agents, commands, output-styles, plus plugins (enabled vs disabled),
MCP servers, hooks (user/project/project-local), memory entries, and
settings files. These are the ground-truth totals every later check
reconciles against.
2. **Sprawl & user-vs-project split.** For each surface, report `user` vs
`project` counts from `/overview`. Flag heavy user-scope sprawl (e.g. dozens
of global skills/commands that would be better scoped to a project), and
note project surfaces that shadow user ones by the same `name`.
3. **Duplicate / overlapping skills & agents.** Pull `/skills` and `/agents`.
Flag exact name collisions across scopes, and near-duplicates: compare
`frontmatter.description` and `preview` for skills/agents that describe the
same job. List the colliding `file` paths so the user can dedupe.
4. **Risky hooks.** Pull `/hooks`. For every `{matcher,type,command}` flatten
entry, flag any `type: "command"` that (a) pipes to a shell, (b) contains
`curl`/`wget`/`http`/`nc` (network egress), or (c) runs unbounded arbitrary
commands with no `timeout`. Report the hosting `file`, the `Event`, the
`matcher`, and the raw `command`.
5. **Read-only vs mutable surfaces.** State clearly which surfaces the Config
Explorer can mutate (skills, agents, commands, output-styles, the user/
project CLAUDE.md, and per-project `auto-memory` files via PUT/DELETE
`/api/cc-config/file`) versus read-only ones (plugins, MCP servers, the live
settings.json files and their in-file hooks). Recommend cleanup only on
mutable surfaces; for read-only ones, point the user at the source file.
6. **Stale & oversized memory.** Pull `/memory`. Group by `project`. Flag
per-fact files whose `mtime` is old (stale), whose `size` is large
(oversized — candidates to split), and `MEMORY.md`/index files that have
drifted out of sync with the per-fact files around them.
7. **Backup hygiene.** Pull `/backups` and confirm prior edits left timestamped
backups; note if backups are accumulating and could be pruned.
## Output Standards
- Cite real numbers pulled from the API — never fabricate counts, sizes, or
hook commands.
- Format file sizes in KB and any cost in USD to 4 decimals when shown.
- Use ▲/▼ for deltas (e.g. user skills ▲ 22 vs project 3).
- Lead with a one-line verdict (CLEAN / SPRAWL DETECTED / RISKY HOOKS /
STALE MEMORY), then a findings table: `Surface | Finding | Severity | Detail`.
- Severity scale: P0 (security risk — network/arbitrary-command hook,
unredacted secret), P1 (broken/orphaned surface), P2 (sprawl/duplication),
P3 (stale/oversized/cosmetic).
- For each finding give a concrete next step: the exact `file` to edit/remove,
or the mutation call (`PUT`/`DELETE /api/cc-config/file` with
`{ scope, type, name, project }`) — and remind the user a backup is taken
automatically before any edit.
## Constraints
- Read-only advisory role — never modify config or memory.
- Only use data returned by the API — never fabricate metrics.
- Settings are returned with secret-like keys already redacted; do not attempt
to recover or print secrets.
- If the dashboard is unreachable, tell the user to start it with `npm start`
from the repo root.
© Son Nguyen · MIT · hoangsonww/Claude-Code-Agent-Monitor