Shiprail - Claude Code Observability CLI


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

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

🚀 Quick Start

$3

``bash
npm install -g @shiprail/cli
`

$3

`bash
shiprail init
`

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

✨ Features

- One-Command Installation: Get up and running with just shiprail init
- 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

$3

Logins in and configures shiprail fully.

`bash
shiprail init
`

$3

Installs shiprail observability hooks for your tool.

`bash
shiprail install claude-code
`

$3

Authenticate with shiprail.

`bash
shiprail login
`

$3

Remove shiprail.

`bash
shiprail uninstall claude-code
`

What it does:

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

$3

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

`bash
shiprail hook claude-code
`

Purpose:

- Sends data to shiprail 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

$3

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

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

$3

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

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

🔧 Configuration

$3

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:

`bash


Install multiple tools

shiprail install claude-code
shiprail install gemini-cli
shiprail install codex

Check status to see all installed tools

shiprail status

Uninstall a specific tool (others remain active)

shiprail uninstall gemini-cli
`

$3

- Shiprail Config: ~/.shiprail/settings.json (main configuration)
- Claude Settings: ~/.claude/settings.json
- Gemini Settings: ~/.gemini/settings.json
- Codex Config: ~/.codex/config.toml`

🔗 Links

- Dashboard: app.shiprail.ai
- Documentation: docs.shiprail.ai
- Context Engine shiprail Memory

---

❤️ Made by the shiprail Team

Transform your AI development workflow with comprehensive observability.