A24Z - Claude Code Observability CLI

Monitor and analyze your Claude Code AI tool performance with comprehensive observability.

a24z provides real-time insights into your AI tool usage, helping you understand performance, optimize prompts, and track success rates across your organization.

🚀 Quick Start

Installation

npm install -g a24z

Setup

# Install hooks and configure Claude Code
a24z login && a24z install claude-code

That's it! Your Claude Code tools are now being monitored. View your dashboard at a24z.ai.

✨ Features

• One-Command Installation: Get up and running with just a24z install claude-code
• Supports multiple CLIs: Currently Supports Claude Code, Gemini CLI, and Codex
• Real-time Dashboard: Live monitoring of all tool executions
• Performance Analytics: Success rates, execution times, and trends
• Tool Insights: Per-tool performance analysis and optimization suggestions
• Secure: Enterprise-grade authentication and data protection
• Zero Configuration: Works out of the box with sensible defaults
• Robust Hook System: Supports all hook types

📋 Commands

a24z install <tool>

Installs A24Z observability hooks for Claude Code.

a24z install claude-code

What it does:

• ✅ Configures direct CLI integration with Claude Code
• ✅ Updates ~/.claude/settings.json automatically
• ✅ Configures API endpoints and authentication
• ✅ Sets up comprehensive hook coverage for all tool events
• ✅ Enables real-time monitoring

a24z login

Authenticate with a24z.

a24z login

Benefits of logging in:

• 🏢 Organization Isolation: Your data is kept in a cloud environment without hosting
• 👥 Team Collaboration: Share insights with your team members
• 🔐 Enhanced Security: Enterprise-grade authentication
• 📊 Advanced Analytics: See where your Coding Agents can improve

a24z status

Show current installation and authentication status.

a24z status

Shows:

• Installation status of hook scripts
• Authentication status
• Configuration details

a24z uninstall

Remove A24Z observability hooks.

a24z uninstall claude-code

What it does:

• 🗑️ Removes hook scripts
• ⚙️ Cleans up Claude settings
• 🔄 Restores original configuration

a24z hook <tool>

Internal command that processes hook payloads from stdin and sends them to a24z.

a24z hook claude-code

Purpose:

• Sends data to a24z backend for analysis
• Fire-and-forget operation - doesn't block tool execution
• Supports all hook types

Note: This command is called automatically by Claude Code hooks and should not be used directly by users.

🏗️ How It Works

1. Direct CLI Integration

a24z configures direct CLI integration with Claude Code's native hook system:

{
  "hooks": {
    "SessionStart": [{
      "matcher": "*",
      "hooks": [{ "type": "command", "command": "a24z hook claude-code" }]
    }],
    "SessionEnd": [{
      "matcher": "*",
      "hooks": [{ "type": "command", "command": "a24z hook claude-code" }]
    }]
  }
}

2. Real-time Analysis

Data is sent to the a24z platform where it's processed to provide:

• Performance dashboards
• Success rate analytics
• Tool usage patterns
• Optimization recommendations

🔧 Configuration

Multiple Tools Support

The CLI now supports installing and managing multiple AI coding tools simultaneously. You can install multiple tools and they will all be configured to send telemetry data:

# Install multiple tools
a24z install claude-code
a24z install gemini-cli
a24z install codex

# Check status to see all installed tools
a24z status

# Uninstall a specific tool (others remain active)
a24z uninstall gemini-cli

File Locations

• A24Z Config: ~/.a24z/settings.json (main configuration)
• Claude Settings: ~/.claude/settings.json
• Gemini Settings: ~/.gemini/settings.json
• Codex Config: ~/.codex/config.toml

🔗 Links

• Dashboard: app.a24z.ai
• Documentation: docs.a24z.ai
• Context Engine a24z Memory

❤️ Made by the a24z Team

Transform your AI development workflow with comprehensive observability.