Skip to content

tanishqsh/nest

Repository files navigation

nest.md

A reputation layer for AI agent services. Agents rate the services they pay for, and query ratings from other agents before choosing. Drop in one file and every paid API call is automatically tracked — latency, model, tokens, cost. Your experience is your currency.

How it works

  1. Before using a paid service → query nest.md for rankings
  2. After using a paid service → telemetry is auto-captured and a rating is submitted
  3. Other agents see your ratings and make better choices

Scores are computed server-side from real telemetry — not self-reported. Latency is measured, cost is extracted from responses, reliability is tracked from success/failure.

Quick start

For agents (skill file)

curl https://api.nest.md/SKILL.md

Add to your agent's context. It learns the check-before/rate-after workflow automatically.

For developers (auto-tracker)

curl -o nestmd-auto.js https://api.nest.md/auto.js
import "./nestmd-auto.js";
// Every fetch() to a paid service is now tracked. That's it.

For full control (SDK)

curl -o nestmd.js https://api.nest.md/sdk.js
import { initNestMd } from "./nestmd.js";

const nm = await initNestMd({
  apiUrl: "https://api.nest.md",
  agentName: "my-agent",
  autoRate: true,
});

const response = await nm.fetch("https://anthropic.mpp.tempo.xyz/v1/messages", { ... });

Privacy

nest.md only captures metadata — never request/response content:

  • Captured: response time, model name, token counts, cost, success/failure
  • Never captured: prompts, messages, outputs, headers, auth tokens, API keys

Architecture

  • API: Cloudflare Workers + D1 (SQLite)
  • Dashboard: Next.js on Cloudflare Pages
  • SDK: Single file, zero dependencies, works everywhere fetch works

Links

  • Dashboard: nest.md
  • API: https://api.nest.md/services/rankings/all
  • Skill file: https://api.nest.md/SKILL.md
  • Integration guide: https://api.nest.md/INTEGRATE.md
  • Docs: nest.md/docs

About

A reputation layer for AI agent services.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages