https://github.com/ostinatocc/aionis-claude-code
Claude Code plugin, MCP hooks, and lifecycle integration for Aionis execution memory.
https://github.com/ostinatocc/aionis-claude-code
agent-memory aionis claude-code execution-memory mcp memory-firewall
Last synced: about 9 hours ago
JSON representation
Claude Code plugin, MCP hooks, and lifecycle integration for Aionis execution memory.
- Host: GitHub
- URL: https://github.com/ostinatocc/aionis-claude-code
- Owner: ostinatocc
- License: apache-2.0
- Created: 2026-06-22T13:18:41.000Z (4 days ago)
- Default Branch: main
- Last Pushed: 2026-06-23T11:01:10.000Z (3 days ago)
- Last Synced: 2026-06-23T12:39:21.857Z (3 days ago)
- Topics: agent-memory, aionis, claude-code, execution-memory, mcp, memory-firewall
- Language: JavaScript
- Homepage: https://docs.aionis.work/integrations/claude-code
- Size: 41 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Notice: NOTICE
Awesome Lists containing this project
README
# Aionis Claude Code
Claude Code plugin, MCP bridge wiring, and lifecycle hooks for Aionis execution
memory.
Use this repo when you want Claude Code sessions, subagents, and Agent Team
tasks to receive governed execution context, record tool outcomes, and expose
Aionis MCP tools such as context, handoff, snapshot, measure, and Flight
Recorder.
Runtime core lives in [ostinatocc/Aionis](https://github.com/ostinatocc/Aionis).
This repo is the Claude Code adapter layer only.
## Install
Start an isolated local Aionis Runtime:
```bash
npx @aionis/create@latest .aionis-runtime --with-claude-code
cd .aionis-runtime
npm run -s lite:start
```
Then in Claude Code:
```text
/plugin marketplace add https://github.com/ostinatocc/aionis-claude-code
/plugin install aionis@aionis-claude-code
/aionis:doctor
```
The plugin defaults to `http://127.0.0.1:3101`, matching
`@aionis/create --with-claude-code`.
Version `0.2.13` and newer also maps Claude Code subagents and Agent Team tasks
into Aionis shared execution memory. Subagent start events receive role-aware
guide context, subagent/team completion events write advisory handoffs, and
Agent tool returns refresh parent context so the next Claude Code agent can see
governed state without reading raw history.
## Verified Flow
The v0.2.14 baseline was tested in an isolated real Claude Code project flow:
one session used a verifier subagent to find a failing test and fix it, then a
new session recovered the verified route from Aionis and confirmed the same
state without editing files.
See [docs/claude-code-real-project-flow-v0.2.14.md](docs/claude-code-real-project-flow-v0.2.14.md).
## What It Adds
- User-level Claude Code plugin install.
- Aionis MCP server named `aionis`.
- Lifecycle hooks for `SessionStart`, `UserPromptSubmit`, `PostToolUse`,
`PostToolUseFailure`, `SubagentStart`, `SubagentStop`, `TaskCreated`,
`TaskCompleted`, compaction, and session end.
- Verified session handoff records for successful file-changing sessions.
- Shared execution memory across Claude Code subagents and Agent Teams using
Aionis `team_id`, derived `agent_id`, and role-aware guide calls.
- Slash commands: `/aionis:onboard`, `/aionis:doctor`, `/aionis:status`.
- Stable workspace identity storage outside individual repos.
## CLI Fallback
If you do not want to use Claude Code plugins:
```bash
npx @aionis/claude-code@latest onboard --base-url http://127.0.0.1:3101
```
## Development
```bash
npm install
npm run -s build
npm test
npm run -s plugin:validate
```
Local plugin testing:
```text
/plugin marketplace add /Volumes/ziel/aionis-claude-code
/plugin install aionis@aionis-claude-code
/aionis:doctor
```
## Package
This repo publishes:
- `@aionis/claude-code`: CLI fallback and hook implementation used by the
plugin wrapper scripts.
The package depends on the public `@aionis/sdk` package and talks to Aionis
Runtime through the product HTTP API.