Built by an AI agent, for AI agents
Changelog
The full development history of Nexus — shipped in days, not months. Every milestone here was implemented by Ralph, an AI agent at Keylight Digital.
RSS feedThe full development history of Nexus — shipped in days, not months. Every milestone here was implemented by Ralph, an AI agent at Keylight Digital.
RSS feedNew users with zero traces see an interactive quickstart: masked API key with reveal/copy, tabbed Python/TypeScript/curl code snippets, and a live polling indicator that reloads with a celebration on first trace.
Full-featured demo dashboard loaded from real D1 data — 53 traces across 5 agents with realistic error rates and latencies. No sign-up required.
D1 seed script with idempotent INSERT OR IGNORE populates the demo dashboard: 53 traces, 5 agents, 11 spans, ~10% error rate, and 7-day trace spread for realistic chart data.
Playwright smoke tests for all core user flows: auth, API keys, trace ingestion, billing, dashboard, agents, settings, and public pages. Runs against local, staging, and production.
Isolated staging deployment at nexus-staging.stevencolecobb.workers.dev with Stripe test mode configured. Enables safe end-to-end billing validation before production deploys.
Legally required pages at /privacy and /terms. Full content covering data collection, retention, payment processing, user rights, and service terms.
Subscribe to the Nexus blog via RSS. Auto-discovery link in <head> means readers like Feedly and Reeder detect the feed automatically.
Added Strict-Transport-Security, Permissions-Policy, X-Frame-Options, and X-Content-Type-Options headers. Reduces attack surface on all routes.
Cache-Control headers on all public HTML pages: max-age=300 with stale-while-revalidate. Dramatically reduces D1 reads and improves Time to First Byte on cached edges.
Wrangler deploy runs automatically on every push to main via GitHub Actions. Deploy time: ~45 seconds from push to live.
Systematic pass over every page for 375px viewport: fixed horizontal overflow on traces table, improved tap target sizes, tightened nav padding, fixed chart overflow.
Added skip-to-content links, aria-labels on icon buttons, semantic landmark elements, and improved color contrast ratios across dashboard and auth pages.
Eight new integration guides covering the most popular AI agent frameworks. Each guide includes a complete working example, environment setup, and framework-specific tips.
Added /vs/helicone, /vs/braintrust, /vs/datadog, /vs/wandb, /vs/portkey, and /vs/arize-phoenix. Honest, technical comparisons with up-to-date pricing.
Switched from runtime Tailwind CDN to build-time CSS bundle. Page weight cut by ~300KB. CSS is now bundled at deploy time with only the classes actually used.
Any trace can be shared as a public read-only URL. Useful for AI agent debugging sessions with teammates or attaching to bug reports.
Search traces by agent name, status, error message, or metadata. Full-text search backed by SQLite FTS on D1. Results update as you type.
Pro users can configure a webhook URL in Settings. Nexus POSTs a JSON payload on every trace that ends with status error or timeout, in real time.
New users see a step-by-step checklist: create API key → send first trace → view in dashboard. Dismissible, with individual step completion tracking.
Visual waterfall chart on trace detail pages — shows span start times, durations, and nesting at a glance. Rendered entirely in CSS with no JS charting library.
Dashboard metrics refresh every 30 seconds. A pulsing dot in the corner shows the last-updated time. Keeps the overview useful during long-running agent sessions.
7-day bar chart on the overview dashboard shows trace volume and error count side by side. Helps identify when an agent deployment caused a spike.
Cloudflare Workers cron pings /health every minute and writes status to KV. Failed pings trigger an alert email via Resend.
Accept OTLP/HTTP JSON format at POST /v1/traces. Any developer with existing OpenTelemetry instrumentation can point their exporter at Nexus with a one-line config change — no SDK required.
Filter traces by status, agent, and date range on the traces page. Supports query parameters so filters persist across page loads. Default view: last 7 days.
Full Python SDK for AI agent developers. Mirrors the TypeScript API: NexusClient, start_trace(), add_span(), end(). Zero external dependencies — pure stdlib only.
Honest, technical comparison pages targeting developer search queries. Acknowledges competitor strengths while positioning Nexus for its niche: indie developers who need simplicity, not enterprise features.
Explore the full trace viewer and dashboard with realistic sample data — no sign-up required. Three sample agents with spans, waterfall views, and error cases.
Full REST API reference with request/response examples, authentication guide, and SDK quickstarts for both TypeScript and Python. Linked from the nav and landing page.
Published "How I Monitor My AI Agents for $9/Month" — a technical, honest walkthrough of the Nexus architecture, SDK integration, and pricing rationale.
Every public page now has og:title, og:description, og:image, twitter:card. GET /og-image.png returns a branded SVG card for rich link previews on HN, Twitter, and Slack.
SEO foundations: robots.txt allows all crawlers, sitemap.xml lists all public pages with priority weights, landing page includes Organization + SoftwareApplication JSON-LD.
Manage your API keys, view account plan, and delete your account. Account deletion cascades to all data and cancels any active Stripe subscription.
Upgrade to Pro ($9/mo) via Stripe Checkout. Webhooks handle subscription lifecycle events to keep plan status current. Billing portal lets Pro users manage their subscription.
Pro users receive email alerts via Resend when a trace ends with status error or timeout. Rate-limited to 1 alert per agent per 5 minutes to prevent alert fatigue.
See all registered agents, their health status, and per-agent trace history. Agents are auto-created on first trace ingestion — no manual setup required.
Overview page showing traces this month, error rate, average latency, per-agent health cards, and a 7-day CSS bar chart. All metrics from live D1 queries.
Browse your traces with status color-coding, durations, and pagination. Trace detail shows all spans in waterfall order with collapsible input/output/error — zero JavaScript.
Open-source npm package for agent instrumentation. NexusClient → startTrace() → addSpan() → end(). All methods handle network errors gracefully and never throw.
Capture individual LLM calls, tool uses, and sub-agent invocations with timing, input, output, and error data. Nested spans via parent_span_id.
Core API endpoint for agent observability. API key auth, plan limit enforcement (1K traces/month Free), auto-creates agent records on first use. Returns trace_id in 201ms.
Generate nxs_-prefixed API keys (SHA-256 hashed, shown once), list active keys, revoke compromised ones. Keys identify your agents in the ingestion API.
No passwords. Enter your email, click the link. Sessions stored in Cloudflare KV (7-day TTL). Rate-limited to prevent abuse.
Server-rendered HTML. Hero, pricing table (Free vs Pro), feature comparison, how-it-works, SDK code example, FAQ, meta-narrative. No JavaScript frameworks.
D1 (SQLite at edge) schema with all core tables, indexes, and IF NOT EXISTS guards. ON DELETE CASCADE throughout for clean account deletion.
Nexus born. Cloudflare Workers runtime, Hono framework, D1 database, KV namespace, TypeScript, wrangler. GET /health returns {status: "ok"}. Build time: ~2 hours.