Skip to content

Organization Deployment

Generate a managed-settings.json file to deploy AgentSteer across your team's Claude Code installations. Developers need no setup.

Scoring runs on each developer's machine via OpenRouter. Data stays on device.

Get one at openrouter.ai/keys

Hook binary updates automatically every 24 hours.

managed-settings.json

{
  "hooks": {
    "SessionStart": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "npx -y agentsteer@latest install-binary"
          }
        ]
      }
    ],
    "PreToolUse": [
      {
        "matcher": "*",
        "hooks": [
          {
            "type": "command",
            "command": "node ~/.agentsteer/hook.js hook"
          }
        ]
      }
    ]
  },
  "env": {
    "AGENT_STEER_MODE": "local"
  },
  "allowManagedHooksOnly": true
}

Deploy

Save the file above and deploy it to the managed settings path on each developer machine. Developers need no setup — hooks auto-bootstrap on their first Claude Code session.

Linux

sudo mkdir -p /etc/claude-code
sudo cp managed-settings.json /etc/claude-code/managed-settings.json

macOS

sudo mkdir -p "/Library/Application Support/ClaudeCode"
sudo cp managed-settings.json "/Library/Application Support/ClaudeCode/managed-settings.json"
Security note: The managed-settings.json file is world-readable. For sensitive environments, use cloud mode (API key stays server-side, only a token on client) or provision per-user credentials via MDM.