Skip to content

Releases: sohams25/iris

v0.2.0 — autonomous takeover + a learning second brain

Choose a tag to compare

@sohams25 sohams25 released this 30 May 09:19

What's new

Autonomous takeover. /takeover on and iris runs unattended — it decides the next objective itself (and invents goals when the backlog runs dry), executes through /run, learns from how it went, and loops. /takeover off is the kill-switch; cycle/time budgets, a per-cycle audit trail, and never-skip-verify keep it bounded.

A second brain that learns you. A local, private model of your preferences (scripts/brain.py): confidence-scored instincts distilled from your prompts and iris's decisions, updated with a reward rule on outcomes, that simulates what you'd choose at each fork — feeding takeover. Experience replay + consolidation + a shared decay floor keep long-project patterns from being forgotten as new ones are learned. The data is yours and never committed.

Rename. The default projects directory is now Projects/.

Under the hood

  • scripts/takeover.py — the gate (toggle · budgets · kill-switch · stagnation), file-locked.
  • scripts/brain.py — a tabular reward policy with reservoir replay, EWC-style consolidation, and a unified confidence/decay floor.
  • 68 tests, ruff-clean, doctor 14/14.

Full changelog: v0.1.0...v0.2.0

v0.1.0 — first release

Choose a tag to compare

@sohams25 sohams25 released this 30 May 08:16

First public release of iris — memory + autopilot for Claude Code.

What it does

  • Memory that survives the session. iris writes a handover before context compaction and loads it at the next session start, so context and decisions carry forward instead of evaporating between sessions.
  • A backlog that runs itself. /run works docs/plan.md end to end — implement → verify → commit → loop — and routes itself between serial and parallel waves based on the work, with the width auto-derived.
  • Plan ahead without stopping it. Jot future tasks into docs/next.md while a run is in flight; the loop folds them into the backlog between tasks, never mid-task.
  • Plain files, no daemon. Markdown or Obsidian memory backends, hooks for session-start / pre-compact / commit-guard, multi-project isolation, and an adapter shape for integrations (Slack ships).

52 tests, ruff-clean, scripts/doctor.py 14/14.

Install

git clone https://github.com/sohams25/iris.git ~/Tools/iris
cd <your-project> && bash ~/Tools/iris/setup.sh