Kubiks CLI

🎬 Demo

🎯 What is Kubiks CLI?

When something breaks in your Next.js app, wouldn't it be amazing if your AI code editor could see exactly what happened? Kubiks CLI makes this possible.

• 📊 Capture everything: Requests, AI SDK calls, tool calls and many more
• 🤖 Feed Cursor complete context available to Cursros through MCP (Model Context Protocol)
• ⚡ Debug faster: Ask Cursor to fix issues with full trace data and request payloads

🔥 Quick Start

1. Install Kubiks CLI

Via npm (macOS/Linux)

npm i -g @kubiks/cli

Or via Homebrew (macOS/Linux)

brew install kubiks-inc/tap/kubiks

Or download for your platform

⬇️ Download from releases

2. Set up OpenTelemetry in your Next.js app

Install the Vercel OTEL package

npm i @vercel/otel

Create instrumentation.ts in your Next.js app root directory

// instrumentation.ts
import { registerOTel, OTLPHttpJsonTraceExporter } from "@vercel/otel";

export function register() {
  registerOTel({
    serviceName: "your-project-name",
    traceExporter: new OTLPHttpJsonTraceExporter({
      url: process.env.OTEL_EXPORTER_OTLP_ENDPOINT,
    }),
  });
}

Enable experimental telemetry for AI SDK calls

To capture AI SDK calls like generateText, streamText, and generateObject, you need to enable experimental telemetry in your AI SDK configuration:

import { generateText } from 'ai';

const result = await generateText({
  model: 'openai/gpt-4',
  prompt: 'Hello, world!',
  experimental_telemetry: {
    isEnabled: true,
  },
});

Note: This experimental telemetry feature must be enabled for each AI SDK call to ensure proper trace capture.

3. Start debugging like a pro

# In your Next.js project directory
kubiks

This will automatically configure the OpenTelemetry environment variables and start capturing traces from your Next.js application.

🤝 Contributing

We welcome contributions! This is an open-source project built for the developer community.

Quick Development Setup

git clone https://github.com/kubiks-inc/kubiks-cli.git
cd kubiks-cli
make deps
make test
make build

🌟 Star us!

Drop us a star — it keeps us building!

⭐ Star on GitHub

📄 License

Apache 2.0 License - see LICENSE file for details.

🛟 Support & Community

• 🐛 Report issues
• 💡 Request features
• 💬 Join discussions
• 📧 Email: [email protected]

Made with ❤️ by engineers, for engineers. Happy debugging! 🐛✨