# Superdense > Superdense is an open-source, local-first tool that makes your AI coding agents loop on a real-world goal and keep getting better at hitting it, every run. Superdense gives coding agents (Claude Code, Codex, Cursor, OpenCode) durable memory and a feedback loop tied to a real-world metric. You name a north star, run the outcome loop, and every run compounds toward the outcome instead of starting cold. It runs entirely on your machine. Install: `npm i -g @nimrobo/superdense`. ## What is the outcome loop? The outcome loop is a four-command cycle your agent runs against one real-world metric: - `/outcome-setup` — scaffold `goal.md` (north star + guardrails), `run.md` (the lever portfolio), and `gate.md` (the completion contract). - `/outcome-run` — pick one lever, ship one action, record a falsifiable hypothesis and its reward. - `/outcome-update` — promote levers that worked, retire levers that failed. Each run is either `explore` (test an uncertain hypothesis) or `exploit` (rep a proven one). Superdense is the durable store for the sessions, artifacts, hypotheses, experiments, and reward snapshots the loop produces. ## How is this different from evals? Evals score a model on a fixed benchmark. The outcome loop optimizes an agent against a moving, real-world outcome (signups, reach, recovered revenue, organic traffic) and compounds across runs by remembering what moved the metric and what did not. ## Core concepts - [North star](https://www.nimroboai.com/docs/outcome): The one real-world outcome that counts as progress — stable, measurable, and owned by goal.md. - [Guardrail](https://www.nimroboai.com/docs/outcome): A constraint that stops a cheap win from quietly degrading quality (e.g. "no engagement bait", "bounce rate must not rise"). - [Lever](https://www.nimroboai.com/docs/outcome): A mechanism you believe moves the north star — something you can pull, like hook quality or signup friction. - [Lever portfolio](https://www.nimroboai.com/docs/outcome): The archive of all levers in run.md, each tagged candidate, promising, proven, exhausted, or retired. - [Action](https://www.nimroboai.com/docs/outcome): One concrete step on a lever this run — a rep of a proven recipe, or a fix to something in the path. - [Diagnostic metric](https://www.nimroboai.com/docs/outcome): A measurement that explains why a lever did or did not move the north star. - [Hypothesis](https://www.nimroboai.com/docs/outcome): A falsifiable prediction attached to one lever, recorded in Superdense before the outcome is known. - [Experiment](https://www.nimroboai.com/docs/outcome): The Superdense record binding a hypothesis to one or more runs/artifacts and a reward window. - [Mode](https://www.nimroboai.com/docs/outcome): Each run is either explore (test an uncertain hypothesis) or exploit (rep a supported one on a proven lever). - [Gate](https://www.nimroboai.com/docs/outcome): The reusable completion contract that says what must be true before a run is called complete. ## Outcome packs Outcome packs are ready-made loops — a north star, guardrails, and a lever map your agent can start running today. - [X Reach](https://www.nimroboai.com/docs/outcome/packs/x-reach): North star — impressions per post, measured via X API public_metrics (impression_count). - [Landing Page Conversion](https://www.nimroboai.com/docs/outcome/packs/landing-page-conversion): North star — % of unique landing-page visitors who complete the signup action, measured in your analytics tool over a consistent window (7 days is a common starting point — adjust to match your traffic volume). - [Turn Signups into Active Users](https://www.nimroboai.com/docs/outcome/packs/turn-signups-into-active-users): North star — % of signups who reach the aha moment within a defined window (7 days is a common starting point — adjust based on your product's typical time-to-value). - [Recover Failed Subscription Payments](https://www.nimroboai.com/docs/outcome/packs/recover-failed-subscription-payments): North star — % of failed subscription payments that recover within a fixed window, measured from your billing provider's failed-payment event to a paid/captured payment event. ## Reward connectors Connectors let the loop read an artifact's real-world reward through an official CLI or API. - [GitHub connector](https://www.nimroboai.com/docs/reward/connectors/github): reads reward via `gh` — comments, reactions, merge state, review state, stars, forks, release asset downloads. - [npm connector](https://www.nimroboai.com/docs/reward/connectors/npm): reads reward via `npm` — downloads, dependents, version adoption. - [X (Twitter) connector](https://www.nimroboai.com/docs/reward/connectors/x): reads reward via `xurl` — views (impressions), likes, reposts, replies, bookmarks. - [Stripe connector](https://www.nimroboai.com/docs/reward/connectors/stripe): reads reward via `stripe` — signups, conversions, conversion rate, revenue, MRR delta. - [Razorpay connector](https://www.nimroboai.com/docs/reward/connectors/razorpay): reads reward via `razorpay` — payments, captured amount, failed amount, recovered amount, invoice status, subscription status. - [Vercel connector](https://www.nimroboai.com/docs/reward/connectors/vercel): reads reward via `vercel` — visitors, pageviews, top paths, and (with Web Analytics) conversions. - [Netlify connector](https://www.nimroboai.com/docs/reward/connectors/netlify): reads reward via `netlify` — visitors, pageviews, top sources, bandwidth. - [Resend connector](https://www.nimroboai.com/docs/reward/connectors/resend): reads reward via `resend-cli` — delivered, opens, clicks, open rate, click rate, bounces. - [Google Analytics (GA4) connector](https://www.nimroboai.com/docs/reward/connectors/google-analytics): reads reward via `GA4 Data API` — users, sessions, pageviews, events, conversions, retention. - [YouTube connector](https://www.nimroboai.com/docs/reward/connectors/youtube): reads reward via `YouTube Data API v3` — views, likes, comments, and (via Analytics API) watch time. - [Instagram connector](https://www.nimroboai.com/docs/reward/connectors/instagram): reads reward via `Meta Graph API` — reach, impressions, likes, comments, saves, video views. - [Substack connector](https://www.nimroboai.com/docs/reward/connectors/substack): reads reward via `community CLI (sbstck-dl)` — views, opens, likes, comments, subscriber delta (dashboard-only for most). ## Optional - [Superdense on GitHub](https://github.com/Nimrobo/superdense): the open-source code and README. - [Outcome packs index](https://www.nimroboai.com/docs/outcome): all packs and the outcome-loop reference. - [Reward connectors index](https://www.nimroboai.com/docs/reward): the full connector taxonomy.