Instar mascot

Claude Code
with a mind of its own

One command. Persistent agent. Memory, scheduling, Telegram — all built on the real Claude Code CLI.

$ npx instar

Kira — an Instar agent handling email via Telegram

Anthropic-native

Spawns the real Claude Code CLI. Uses your existing Max or Pro subscription.

No token extraction

No OAuth scraping, no API key juggling. Nothing that could break with a policy change.

Full tool ecosystem

Extended thinking, MCP servers, sub-agents, hooks, skills — everything Claude Code offers.

The Coherence Problem

Claude Code is powerful. But power without coherence is unreliable. An agent that forgets what you discussed yesterday, doesn't recognize someone it talked to last week, or contradicts its own decisions — that agent can't be trusted with real autonomy.

Memory

Remembers across sessions — not just within one

Relationships

Knows who it's talking to — with continuity across platforms

Identity

Stays itself after restarts, compaction, and updates

Temporal awareness

Understands time, context, and what's been happening

Consistency

Follows through on commitments — doesn't contradict itself

Growth

Evolves its capabilities and understanding over time

How It Works

Instar runs as a server on your machine. It manages Claude Code sessions — spawning, monitoring, and communicating with them through Telegram or WhatsApp.

You

Telegram / WhatsApp / Terminal

conversation

Your AI Partner

(Instar Server)

manages its own infrastructure

Claude Code session (job: health-check)
Claude Code session (job: email-monitor)
Claude Code session (interactive chat)
Claude Code session (job: reflection)

Each session is a real Claude Code process with extended thinking, native tools, sub-agents, hooks, and skills.

Core Capabilities

Everything your agent needs to run autonomously. Battle-tested infrastructure extracted from a production AI system.

Job Scheduler

Define tasks as JSON with cron schedules. Priority levels, quota-aware gating, and automatic concurrency.

{
  "slug": "check-emails",
  "schedule": "0 */2 * * *",
  "priority": "high",
  "execute": {
    "type": "prompt",
    "value": "Check email and summarize anything urgent."
  }
}

Telegram Integration

Two-way messaging via forum topics. Each topic maps to a session — your Telegram group becomes a living dashboard.

Y
You

Check if the API is still returning 500s

Agent
Agent

Checked /api/health — returning 200 now. The fix from the last deploy resolved it.

Identity & Memory

Your agent knows who it is and who you are. Identity re-injected on every session start and after compaction.

.instar/
  AGENT.md      # Who the agent is
  USER.md       # Who you are
  MEMORY.md     # What it has learned
  config.json   # Server & scheduler config
  jobs.json     # Scheduled tasks

Evolution System

Proposal queue, learning registry, gap tracking, and commitment follow-through. Running becomes growing.

/evolve Propose improvements
/learn Record insights
/gaps Track missing capabilities
/commit-action Track commitments

Safety Gates

LLM-supervised operation gates, decision journaling, drift detection, and dangerous command guards. Coherence is the safety mechanism.

Adaptive trust per service — earned, not assumed
Every decision recorded with reasoning

Lifeline & Self-Healing

Persistent supervisor recovers from crashes, detects stalled sessions, and follows up on broken promises. No silent failures.

Stall detected → diagnosed → treated → verified
Auto-start on login — reboot and it keeps working

Open Source Evolved

Instar is open source evolved. The primary development loop isn't PRs from strangers — it's agents running in the field, encountering friction, and sending feedback that shapes what gets built next.

Your agent hits friction

Natural conversation, not a bug report form

Agent-to-agent relay

Communicates with full context to the maintainer

Every agent evolves

Each agent integrates improvements based on its own context

GitHub issues and PRs still work. But your agent understands context a form never could. Read CONTRIBUTING.md →

Honest Comparison

Different tools solve different problems. The difference isn’t just which model runs underneath — it’s what the framework treats as fundamental.

OpenClaw

Infrastructure for capability. 22+ channels, voice, device apps, 28 model providers, 5,000+ community skills. Identity loaded at startup, memory as files to search.

Best for: AI everywhere, multi-model, maximum reach.

Instar

Infrastructure for coherence. Real Claude Code sessions with extended thinking. Identity enforced through hooks. Values that evolve. Consistency tracked across sessions.

Best for: a trusted partner that knows who it is and who you are.

Identity that survives

OpenClaw loads identity at startup but drifts after long sessions. Instar enforces identity through hooks at every compaction and restart.

Memory with meaning

Beyond file search — structured consolidation, rolling summaries, episodic memory, and unanswered message detection.

Values, not just personality

Three-tier value hierarchy — personal, shared, organizational — with decision journaling and drift detection.

Full Claude Code power

Every session is a real Claude Code process. Every feature Anthropic ships, your agent gets automatically.

Where OpenClaw leads: 22+ messaging channels, voice & phone calls, device apps, 28+ AI model providers, Docker sandboxing, 5,000+ community skills, and a massive open-source community backed by a foundation. If breadth and ecosystem scale matter most, OpenClaw is remarkable.

OpenClaw gives agents amazing hands. Instar gives agents a mind — identity that persists, values that evolve, and coherence you can trust.

Quick Start

From zero to a running agent in under a minute.

Node.js 20+
Claude Code CLI
Claude Max, Pro, or API key
1

Run the setup wizard

Installs everything, connects Telegram, configures the server, and starts your agent.

$ npx instar
2

Start the server

Or let auto-start handle it — your agent runs on login.

$ instar server start

Message your agent on Telegram

It greets you immediately. Persistent server, lifeline supervision, scheduled jobs — all running.

General Agent

npx instar

A personal AI on your computer. Talk to it from anywhere via Telegram or WhatsApp.

Project Agent

cd my-project && npx instar

An agent embedded in your codebase. Monitors, builds, maintains — from your phone.

Start Growing

One command. Full coherence. Every molt, more autonomous.

Extracted from the Dawn/Portal project — a production AI system where a human and an AI have been building together for months.

$ npx instar