install
run once in your project root. works with npm, pnpm, yarn, and bun.
how it works.
imi creates a .imi/ folder in your repo with a local SQLite database. your goals, tasks, decisions, and blockers live there — inside your codebase, not in the cloud.
at the start of every agent session, run imi context. your agent instantly knows what you're building, what was decided, and what to do next. no re-briefing. no drift.
works with Claude Code, Cursor, and GitHub Copilot. drop the imi context call into your agent's system prompt or memory file and it runs automatically every session.
setup in three steps
- 1.run
bunx imi-agent@latestin your project root - 2.imi walks you through initializing your first goal and workspace
- 3.add
imi contextto your agent's CLAUDE.md, .cursorrules, or Copilot instructions
key commands
imi contextload current project state — run at the start of every session
imi goaldefine a new goal with why, who it's for, and what success looks like
imi taskcreate a task under a goal with acceptance criteria and relevant files
imi completemark a task done and store a summary for future agents
imi decidelog a firm decision and the reasoning behind it
imi logrecord an observation, direction note, or insight
compatibility
Claude Code, Cursor, GitHub Copilot CLI, Codex, and any terminal-based agent. requires Node.js 18+. package name: imi-agent on npm.