Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (a24z) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

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 (One Command!)

# Install hooks and configure Claude Code
a24z install

# Login for multi-tenancy (optional)
a24z login

# Check everything is working
a24z status

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

✨ Features

🔧 One-Command Installation: Automatically configures Claude Code hooks
📊 Real-time Dashboard: Live monitoring of all tool executions
🏢 Multi-tenancy: Organization-based data isolation with WorkOS auth
📈 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

📋 Commands

`a24z install`

Installs A24Z observability hooks for Claude Code.

a24z install                           # Use default hosted service
a24z install --api-url https://your.domain  # Use custom backend

What it does:

✅ Copies hook scripts to ~/.claude/hooks/
✅ Updates ~/.claude/settings.json automatically
✅ Configures API endpoints
✅ Sets up logging and error handling

`a24z login`

Authenticate with A24Z for multi-tenancy support.

a24z login

Benefits of logging in:

🏢 Organization Isolation: Your data is kept separate from other organizations
👥 Team Collaboration: Share insights with your team members
🔐 Enhanced Security: Enterprise-grade authentication
📊 Advanced Analytics: Access to organization-wide metrics

`a24z status`

Show current installation and authentication status.

a24z status

Shows:

Installation status of hook scripts
Authentication status
API connectivity
Configuration details

`a24z uninstall`

Remove A24Z observability hooks.

a24z uninstall

What it does:

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

🏗️ How It Works

1. Hook Installation

A24Z installs lightweight bash scripts that integrate with Claude Code's native hook system:

{
  "hooks": {
    "PreToolUse": [{
      "matcher": "*",
      "hooks": [{ "type": "command", "command": "~/.claude/hooks/a24z-pre-hook.sh" }]
    }],
    "PostToolUse": [{
      "matcher": "*", 
      "hooks": [{ "type": "command", "command": "~/.claude/hooks/a24z-post-hook.sh" }]
    }]
  }
}

2. Data Collection

Pre-hook: Captures tool name, input parameters, and context before execution
Post-hook: Records execution results, success/failure status, and performance metrics
Privacy: Only metadata is collected - your actual code and sensitive data never leaves your machine

3. 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

Environment Variables

# Enable debug logging
export DEBUG_HOOKS=true

# Custom API endpoint (for self-hosted deployments)
export A24Z_API_URL=https://your-api.domain.com

File Locations

Config: ~/.claude/a24z-config.json
Hooks: ~/.claude/hooks/a24z-*.sh
Logs: ~/.claude/a24z.log
Claude Settings: ~/.claude/settings.json

🏢 Enterprise & Self-Hosting

Multi-tenancy

A24Z supports full multi-tenancy with organization isolation:

a24z login  # Authenticate with your organization

Self-Hosted Deployment

Run A24Z on your own infrastructure:

# Install with custom backend
a24z install --api-url https://your-observability.company.com

# Or set permanently
export A24Z_API_URL=https://your-observability.company.com

🛠️ Development

Local Development

git clone https://github.com/your-org/a24z-observability
cd packages/a24z-cli
npm install
npm run build
npm link

# Test locally
a24z --help

Building

npm run build  # Compile TypeScript to dist/

🤝 Contributing

We welcome contributions! Please see our Contributing Guide.

Issues

Found a bug or have a feature request? Open an issue.

📄 License

MIT License - see LICENSE for details.

🔗 Links

Dashboard: a24z.dev
Documentation: docs.a24z.ai
GitHub: github.com/your-org/a24z-observability
Support: support@a24z.ai

Made with ❤️ by the A24Z Team

Transform your AI development workflow with comprehensive observability.