AIIA — AI skill for Claude Code

⌬ AIIA — AI Information Architecture

A·I·I·A. A palindrome on purpose: the architecture mirrors the name.

Your memory on one side. Your AI tools on the other. AIIA is the surface in between — where what you decide becomes what they know, and what they notice becomes what you remember.

Without it, every session starts blank. Every decision gets re-explained. Every pattern gets re-derived. With it, one continuous thread runs between your thinking and the tools that act on it. Claude Code, Cursor, Copilot — pick your tool. The mirror works the same.

Open source. Apache 2.0. Local-first. Free model. Your data stays yours.

[](./CHANGELOG.md) [](./LICENSE) [](./pyproject.toml) [](#status)

---

Quick start

pip install aiia              # PyPI install
aiia                          # first-run check + setup prompt
aiia next                     # surface your top story to work on now
aiia ask "what did I decide about lockfile policy?"

That's the daily loop. `aiia next` chooses, `aiia ask` recalls, `aiia memory add` captures.

If you don't want PyPI, clone and `pip install -e .[dev]`. AIIA needs Python 3.10+, ~5GB free for a local model, and either Ollama running on `localhost:11434` or an `ANTHROPIC_API_KEY` if you prefer cloud tiers.

---

What flows through the mirror

**From you, into your AI tools' working context:**

• Decisions you've made, with the why — recoverable, not buried in a chat log
• Patterns and conventions you've named — applied without re-explaining
• Stories in your backlog — surfaced when relevant, ranked by priority × freshness
• Session history — what you were doing when you stopped

**From your AI tools, back into your record:**

• Observations from running code — what changed, what