integrations/claudecode/v0.1.0

# Release Notes for v0.1.0

This is the **initial release** of **claudecode-memanto**, a standalone package providing native integration of [Memanto's](https://memanto.ai) persistent, cross-session engineering memory directly into [Claude Code](https://docs.anthropic.com/en/docs/agents-and-tools/claude-code/overview) and the [`mattpocock/skills`](https://github.com/mattpocock/skills) ecosystem.

With one `install` command, Claude Code gains semantic recall across terminals, automatic extraction of architectural decisions, and per-profile memory isolation. Your engineering preferences persist seamlessly between runs without repeating instructions.

## New Features & Improvements

### Dual Integration Methodologies
The integration supports two methods for injecting memory, both of which can be installed either **globally** (applying to all projects on your machine) or **locally** (per-project):
1. **Global Lifecycle Hooks (Recommended)**: Wires directly into Claude Code's internal hook lifecycle (`SessionStart`, `UserPromptExpansion`, `Stop`). Memory is recalled and stored invisibly in the background without requiring modified skills or wrapper scripts.
2. **Prompt Injection (Explicit)**: For users who prefer explicit tool calls over hidden hooks, the `CLAUDE.md` installer safely appends memory instructions to your `CLAUDE.md` file, instructing Claude to use the CLI itself.

### Lifecycle Hooks Breakdown
- **`SessionStart`**: Injects a compact snapshot of the developer's most recent engineering memories so every session begins aware of established conventions.
- **`UserPromptExpansion`**: Detects the invoked skill (e.g., `/tdd`, `/grill-with-docs`) and dynamically injects the most relevant memories as an `<engineering-profile>` system-constraint block. Bare prompts are skipped to avoid polluting every turn.
- **`Stop`**: Asynchronously captures the session transcript and distills durable decisions in the background. Guards against `stop_hook_active` re-fires so a session is never distilled twice.

### Active Extraction
- **LLM-Powered Distillation**: Instead of basic keyword matching, the `Stop` hook hands the session summary to Memanto's backend LLM (`answer()`), which actively reads it to distill durable decisions, rules, and preferences into Memanto's 13 typed memory categories.

### Installation & Configuration
- **Local vs Global Install**:
  ```bash
  claudecode-memanto install --method hooks             # Project-local (.claude/)
  claudecode-memanto install --method hooks --global    # Machine-global (~/.claude/)
  ```
- **Environment Variables**:
  - `MOORCHEH_API_KEY`: Required. Powers the Memanto connection.
  - `MEMANTO_AGENT_ID`: Set a custom namespace for shared memory.
  - `MEMANTO_RECALL_LIMIT`: Max memories to inject per turn (default: 15).

## Full Changelog

Full Changelog: https://github.com/moorcheh-ai/memanto/commits/integrations/claudecode/v0.1.0