@neatlogs/wizard
v0.0.8
Published
AI-powered CLI that instruments Neatlogs observability in your project
Readme
@neatlogs/wizard
AI-powered CLI that instruments Neatlogs observability in your project in minutes.
The wizard detects your stack (language, agent framework, LLM providers), then uses an AI agent to add Neatlogs tracing the right way for your setup — installing the SDK, wiring init(), and applying the correct instrumentation (auto-instrumentors, wrapMastra, wrapAISDK, @span/trace, etc.). It leaves behind a project-specific skill so your coding agent can keep instrumenting new code.
Usage
npx @neatlogs/wizardRun it from your project root. All you need is your Neatlogs API key — the wizard prompts for it. Everything else is automatic. The wizard will:
- Detect your stack (Python/TypeScript, framework, providers).
- Authenticate with your Neatlogs API key (the only thing it asks for).
- Install the latest Neatlogs SDK and instrument your code via an AI agent following a framework-specific skill.
- Verify the first trace reaches your Neatlogs dashboard.
- Connect the Neatlogs MCP server to your coding agent (Claude Code / Cursor), so it can query your traces and detections — offered at the end; skip anytime.
You don't pick an SDK version, an endpoint, or which files to touch — the wizard always installs the latest Neatlogs SDK and figures out the rest from your codebase.
CI / advanced flags
For non-interactive runs (CI) you can pass the API key instead of being prompted:
npx @neatlogs/wizard --ci --api-key <key>| Flag | Description |
|------|-------------|
| --api-key <key> | Neatlogs API key (skips the interactive prompt; required with --ci) |
| --ci | Non-interactive mode |
| --install-dir <path> | Project directory to instrument (default: current directory) |
| --debug | Verbose output |
Commands
| Command | Description |
|---------|-------------|
| (default) | Full first-time setup |
| scan | Re-scan for new uninstrumented code and propose instrumentation |
| mcp | Install the Neatlogs MCP server only |
Supported stacks
- Python: OpenAI / Anthropic / Google / Bedrock SDKs, LangChain / LangGraph, CrewAI, OpenAI Agents
- TypeScript: OpenAI / Anthropic SDKs, Vercel AI SDK (
wrapAISDK), Mastra (wrapMastra), LangChain
Requirements
- Node.js >= 20
- A Neatlogs account + API key (neatlogs.com)
License
MIT
