balagan-agent: Settings file for Claude Code

.claude/settings.json

balagan-agent is a settings file for Claude Code from arielshad/balagan-agent. Its token cost is not measured, scanned A, a copy of skills, Apache-2.0.

Agent settings that run commands at selected points during a coding session, such as before or after tasks, when a session starts or ends, and when a task stops.

In plain words
What is it for?
Use them to connect task and todo events to the Entire hooks commands and to run setup or cleanup commands around agent sessions.
Why use it?
They automate session bookkeeping and task-related actions so those steps do not depend on someone remembering to run them manually.

Settings file for Claude Code

Written for Claude Code: PostToolUse hook event. Also seen: names the TodoWrite tool.

This is arielshad/balagan-agent's own configuration. It tells Claude Code how to work on balagan-agent itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything balagan-agent configures →

One of 7 entries in settings.json upstream. Installing this one merges just its entry into your config; the other 6 are separate, each on its own page.

Reuse

Borrowing it

Nothing to install: this file belongs to arielshad/balagan-agent. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/arielshad/balagan-agent/main/.claude/settings.json
Clone the repo
git clone --depth 1 https://github.com/arielshad/balagan-agent

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for balagan-agent

README.md
[![agentmods](https://agentmods.dev/badge/settings/arielshad/balagan-agent/settings/github.svg)](https://agentmods.dev/settings/arielshad/balagan-agent/settings)
Your own site
<a href="https://agentmods.dev/settings/arielshad/balagan-agent/settings"><img src="https://agentmods.dev/badge/settings/arielshad/balagan-agent/settings/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for balagan-agent

Your own site · 80×15
<a href="https://agentmods.dev/settings/arielshad/balagan-agent/settings"><img src="https://agentmods.dev/badge/settings/arielshad/balagan-agent/settings.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session not measured What this adds to a session before it is invoked.
When invoked not measured Not applicable: nothing here is loaded into a session.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin 92% copy Near-identical to another mod in the catalogue.
Security

Grade A, and why

balagan-agent scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 1mo ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

Origin

This is a copy

92% identical to skills — 44 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.

.claude/settings.json · 85 lines

What it actually says

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Task",
        "hooks": [
          {
            "type": "command",
            "command": "entire hooks claude-code post-task"
          }
        ]
      },
      {
        "matcher": "TodoWrite",
        "hooks": [
          {
            "type": "command",
            "command": "entire hooks claude-code post-todo"
          }
        ]
      }
    ],
    "PreToolUse": [
      {
        "matcher": "Task",
        "hooks": [
          {
            "type": "command",
            "command": "entire hooks claude-code pre-task"
          }
        ]
      }
    ],
    "SessionEnd": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "entire hooks claude-code session-end"
          }
        ]
      }
    ],
    "SessionStart": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "entire hooks claude-code session-start"
          }
        ]
      }
    ],
    "Stop": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "entire hooks claude-code stop"
          }
        ]
      }
    ],
    "UserPromptSubmit": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "entire hooks claude-code user-prompt-submit"
          }
        ]
      }
    ]
  },
  "permissions": {
    "deny": [
      "Read(./.entire/metadata/**)"
    ]
  }
}
Same file

What else settings.json configures

This page is one entry in a file that holds 7. Installing the file brings all of them; each is measured and scanned on its own page.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 1mo ago First seen · 85 lines scan A 7de9e567f6d0

Subscribe to this mod's changes

balagan-agent is a settings file published in the GitHub repository arielshad/balagan-agent (12 stars, last pushed 7mo ago), licensed Apache-2.0. Its token cost is not measured: this kind of file is read by the harness, not the model. A static security scan graded it A with 0 findings. It is 92% identical to skills, differing in 44 lines, and is treated as a copy.