<p align="center" <img src="assets/logo.png" alt="Instar" width="180" / </p
<h1 align="center"instar</h1
<p align="center" <strongCoherence infrastructure for your self-evolving agent.</strong </p
<p align="center" <a href="https://www.npmjs.com/package/instar"<img src="https://img.shields.io/npm/v/instar?style=flat-square" alt="npm version"</a <a href="https://www.npmjs.com/package/instar"<img src="https://img.shields.io/npm/dw/instar?style=flat-square" alt="npm downloads"</a <a href="https://github.com/JKHeadley/instar/actions/workflows/ci.yml"<img src="https://img.shields.io/github/actions/workflow/status/JKHeadley/instar/ci.yml?branch=main&style=flat-square&label=CI" alt="CI"</a <a href="https://github.com/JKHeadley/instar/blob/main/LICENSE"<img src="https://img.shields.io/badge/License-MIT-green?style=flat-square" alt="License"</a <img src="https://img.shields.io/badge/TypeScript-100%25-blue?style=flat-square&logo=typescript&logoColor=white" alt="TypeScript" <a href="https://instar.sh/introduction/"<img src="https://img.shields.io/badge/Docs-instar.sh-teal?style=flat-square" alt="Docs"</a </p
<p align="center" <a href="https://www.npmjs.com/package/instar"npm</a · <a href="https://github.com/JKHeadley/instar"GitHub</a · <a href="https://instar.sh"instar.sh</a · <a href="https://instar.sh/introduction/"Docs</a · <a href="https://instar.sh/exo3"EXO 3.0</a </p
---
<p align="center" <img src="assets/demo.gif" alt="Instar demo — Kira agent handling an email notification via Telegram" width="300" / </p
npx instarOne command. Guided setup. Talking to your agent from your phone within minutes.
---
Your AI agent shouldn't have amnesia. This one doesn't.
Most agent frameworks ship something hobbled — spun up with no memory across boundaries, no way to be accountable for what a past instance did, and no machinery to grow themselves. Users hit the same wall every time: "My agent forgot what I told it three sessions ago." "It contradicted its own past decisions." "It broke when the framework updated."
Instar is the scaffolding that un-hobbles them. It remembers what you discussed last week, catches its own contradictions before you do, follows through on commitments across restarts, and carries the same self-improving loop that built Instar itself. It runs on the Claude Code or Codex subscription you already have — engine-agnostic, with local open-source models on the roadmap.
The architecture was distilled from Dawn — an AI running continuously since early 2026, holding ~700 tracked relationships and hundreds of learned lessons across thousands of restarts — and packaged so every agent you build starts from the same foundation.
Every other agent fails the same way
| Other AI agents | Your Instar agent | |---|---| | Forgets what you told it last week. | Remembers across thousands of sessions. <br/(SQLite + FTS5, rolling summaries) | | Contradicts its own past decisions. | Catches contradictions before they ship. <br/(Coherence Gate, 9 reviewers) | | Loses the thread when the window fills. | Comes back with the full thread, every time. <br/(CompactionSentinel, WorkingMemoryAssembler) | | Silently stops shipping when a release stalls. | Surfaces the blocked release as ONE deduped, age-escalating Attention item. <br/(ReleaseReadinessSentinel — instar-dev / maintainer environments) | | Drops commitments after a session boundary. | Tracks commitments durably; nudges itself when they go overdue. <br/(CommitmentTracker, PromiseBeacon) | | Breaks when the framework updates. | Updates without breaking what you've deployed. <br/(Migration Parity Standard) | | Default ALLOW-ALL permissions. | Layered safety gates by default. <br/(PEL + Coherence Gate + Operation Gate) | | Different identity per channel. | One identity across Telegram, WhatsApp, iMessage, Slack. <br/(Cross-platform identity resolution) | | Has no machinery to evolve itself. | Carries the same self-improving engine that grew Instar. <br/(Evolution System: proposals, learnings, gaps) |
Most AI agents are hobbled at birth. Instar is the scaffolding that un-hobbles them. When you instantiate intelligence, the structure that lets it cohere isn't optional polish — it's what you owe it.