Package Exports
- a24z
- a24z/dist/index.js
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
# Install hooks and configure Claude Code
a24z install && a24z login
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
- 📊 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
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": {
"PreToolUse": [{
"matcher": "*",
"hooks": [{ "type": "command", "command": "a24z hook claude-code" }]
}],
"PostToolUse": [{
"matcher": "*",
"hooks": [{ "type": "command", "command": "a24z hook claude-code" }]
}],
"UserPromptSubmit": [{
"matcher": "*",
"hooks": [{ "type": "command", "command": "a24z hook claude-code" }]
}],
"SessionStart": [{
"matcher": "*",
"hooks": [{ "type": "command", "command": "a24z hook claude-code" }]
}],
"SessionEnd": [{
"matcher": "*",
"hooks": [{ "type": "command", "command": "a24z hook claude-code" }]
}],
"SubagentStop": [{
"matcher": "*",
"hooks": [{ "type": "command", "command": "a24z hook claude-code" }]
}],
"Notification": [{
"matcher": "*",
"hooks": [{ "type": "command", "command": "a24z hook claude-code" }]
}],
"Stop": [{
"matcher": "*",
"hooks": [{ "type": "command", "command": "a24z hook claude-code" }]
}],
"PreCompact": [{
"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
Environment Variables
The CLI supports environment-based configuration for development and production environments:
Available Environment Variables
NODE_ENV
: Set todevelopment
orproduction
(default:production
)- Development mode uses
http://localhost:4000
for API andhttp://localhost:3000
for Auth - Production mode uses
https://api.a24z.ai
andhttps://app.a24z.ai
- Development mode uses
A24Z_API_URL
: Override the API endpoint (e.g.,http://localhost:4000
)A24Z_AUTH_URL
: Override the Auth endpoint (e.g.,http://localhost:3000
)WORKOS_CLIENT_ID
: Override the WorkOS client ID for authentication
Usage Examples
# Use development environment
NODE_ENV=development a24z install claude-code
# Use custom endpoints
A24Z_API_URL=http://staging-api.a24z.ai a24z install claude-code
# Combine multiple overrides
NODE_ENV=development A24Z_API_URL=http://localhost:5000 a24z login
Note: Environment variables only apply to new installations. Existing configurations are preserved in ~/.a24z/settings.json
.
Installation with Custom URLs
You can also specify custom URLs during installation using command-line flags:
# Install with custom endpoints
a24z install claude-code --api-url https://custom-api.example.com --auth-url https://custom-auth.example.com
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.