Skip to main content
hook CX Codex

a-team — Claude Code hook: what it does and how to install

a-team is a hook for Claude Code that runs at session start and on clear or compact. It displays team status and loads session instructions.

MIT ★ 1,596 updated 2026-10-29

Install into Claude Code · Manually: put the files in place All methods and platforms ↓
.claude/settings.json
Open on GitHub

What a-team does

The a-team hook runs on SessionStart for startup, clear, or compact. It tries python, python3, and py to run scripts/status.py and display team status. If none of those commands works, it prints a message asking for Python to be installed.

The hook then reads hooks/session-start.md, falling back to skills/using-a-team/SKILL.md. If neither file is available, it prints a prompt to run /orchestrate init when .agent-sync/TEAM.md is missing. The a-team bundle includes 26 specialist agents, 20 workflow skills, an orchestrator, and quality gates; integration and hook support vary by platform.

What it helps with

  • show team status when a session starts
  • load team instructions after clear or compact
  • prompt initialization when .agent-sync/TEAM.md is missing

Example prompts for the agent

  • Start a new session and show the a-team status.
  • After clear, load the team instructions and run /orchestrate init if .agent-sync/TEAM.md is missing.

How to install a-team

Manually: put the files in place

.claude/settings.json

The hooks block: event (PreToolUse, PostToolUse, Stop…) → command. Personal ones go to ~/.claude/settings.json

Step by step, with commands for each platform: Claude Code hooks: what they are, where to configure them, how to block a risky command

Questions about a-team

How do I install a-team in Claude Code?

Add the hook configuration to .claude/settings.json.

What does the a-team hook do?

It displays team status and loads session instructions at startup and after clear or compact.

What does a-team need to show status?

The hook tries to run Python using python, python3, or py. If none works, it prints a message asking for Python to be installed.

Source text

hooks.json · MIT
Hooks bundle shipped with the a-team plugin for Claude Code.

A complete engineering team in one folder with 26 specialist agents, 20 workflow skills, an orchestrator, and quality gates; integration and hook support vary by coding platform.

Triggers on: SessionStart.

```json
{
  "hooks": {
    "SessionStart": [
      {
        "matcher": "startup|clear|compact",
        "hooks": [
          {
            "type": "command",
            "command": "python ${PLUGIN_ROOT}/scripts/status.py 2>/dev/null || python3 ${PLUGIN_ROOT}/scripts/status.py 2>/dev/null || py ${PLUGIN_ROOT}/scripts/status.py 2>/dev/null || echo '⚡ A Team · instala Python para ver o estado'",
            "async": false
          },
          {
            "type": "command",
            "command": "cat \"${PLUGIN_ROOT}/hooks/session-start.md\" 2>/dev/null || cat \"${PLUGIN_ROOT}/skills/using-a-team/SKILL.md\" 2>/dev/null || echo '[A Team] Session started. Run /orchestrate init if .agent-sync/TEAM.md is missing.'",
            "async": false
          }
        ]
      }
    ]
  }
}

```

© RBraga01 · MIT · hashgraph-online/awesome-codex-plugins

Similar hooks

All hooks for Agent setup: memory, context, orchestration →

From the same set391

The whole set →
archcore archcore is a Claude Code hook that brings Git project context into spec-driven development. It runs at session start, before file edits, and after Archcore document operations. CX Codex ★ 1,596repo stars aiboarding aiboarding is a Claude Code and Codex hook that generates, maintains, compresses, and audits AI-agent onboarding files, keeping AGENTS.md and CLAUDE.md current as the codebase changes. CX Codex ★ 1,596repo stars ai-sdlc ai-sdlc — a hook bundle for a six-stage Markdown SDLC in Claude Code. It checks tool calls to block unauthorized file edits and safeguard sensitive project paths. CX Codex ★ 1,596repo stars agent-guard This hook checks tool activity for exposed secrets in Claude Code and Codex. It suits projects that need local checks plus Git and CI safeguards. CX Codex ★ 1,596repo stars amazon-ads-create-dsp-campaign amazon-ads-create-dsp-campaign walks an Amazon DSP Performance+ or Brand+ campaign from intake to launch: paused setup, ad groups per tactic, then activation after two separate approvals. CX Codex +1 ★ 1,596repo stars returns-reverse-logistics returns-reverse-logistics equips your AI agent with domain logic for RMA authorization, item grading, disposition economics, and return fraud checks. CX Codex +1 ★ 1,596repo stars paid-advertising The paid-advertising skill for Claude Code helps plan and audit paid campaigns against platform rules and benchmarks. It covers Google PMax and AI Max, Meta ads, and retail media. CX Codex +1 ★ 1,596repo stars antigravity-2 Connects Codex to local Antigravity 2.0 via a CLI bridge, checks model quotas, hands off tasks to desktop UI, and reads artifacts without duplicating work. CX Codex +1 ★ 1,596repo stars

Project sponsors

Companies that keep this analytics open