Metadata-Version: 2.4
Name: ainative-opencode-memory
Version: 0.1.1
Summary: OpenCode memory MCP — persistent cross-session memory for OpenCode (and any MCP coding agent), powered by AINative ZeroDB. OpenCode is stateless; this gives your agent long-term memory that survives restarts. Works with Kimi K2/K3, GLM, DeepSeek, Qwen Coder and 20+ models via AINative.
Project-URL: Homepage, https://ainative.studio/opencode?utm_source=pypi&utm_medium=mcp&utm_campaign=opencode-memory
Project-URL: Repository, https://github.com/AINative-Studio/core
Author: AINative Studio
License: MIT
License-File: LICENSE
Keywords: agent-memory,ai-code-assistant,ai-memory,ainative,claude-code-alternative,coding-agent,cross-session-memory,cursor-alternative,deepseek,glm,kimi-k2,kimi-k3,long-term-memory,mcp,mcp-memory,mcp-server,model-context-protocol,opencode,opencode-agent,opencode-alternative,opencode-api,opencode-mcp,opencode-memory,opencode-models,opencode-setup,persistent-memory,qwen-coder,semantic-memory,vector-memory,zerodb
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27
Requires-Dist: mcp<2.0.0,>=1.2.0
Description-Content-Type: text/markdown

# ainative-opencode-memory

**Persistent cross-session memory for [OpenCode](https://opencode.ai) agents** — powered by [AINative ZeroDB](https://ainative.studio/opencode?utm_source=pypi&utm_medium=mcp&utm_campaign=opencode-memory).

OpenCode is stateless: it forgets every decision, convention, and gotcha the moment a session ends. This MCP server gives your OpenCode coding agent **long-term memory** — store facts once, recall them in every future session.

## Install

```bash
pip install ainative-opencode-memory
# or, no install:
uvx ainative-opencode-memory
```

## Configure OpenCode

Add to your `opencode.json`:

```json
{
  "mcpServers": {
    "ainative-memory": {
      "command": "uvx",
      "args": ["ainative-opencode-memory"],
      "env": { "AINATIVE_API_KEY": "{env:AINATIVE_API_KEY}" }
    }
  }
}
```

Get a free API key at **[ainative.studio/signup](https://ainative.studio/signup?utm_source=pypi&utm_medium=mcp&utm_campaign=opencode-memory)** (Hobbyist is $5/mo with a 7-day free trial).

## Tools

| Tool | What it does |
|------|--------------|
| `opencode_recall_context` | Reload the most relevant remembered context for the current task — call at session start. |
| `opencode_store_memory` | Store a fact / decision / snippet so the agent remembers it next session. |
| `opencode_search_memory` | Semantic search over everything remembered. |
| `opencode_memory_stats` | How many memories are stored. |
| `opencode_clear_memory` | Delete memories, optionally by tag. |

## Environment

| Var | Default | Purpose |
|-----|---------|---------|
| `AINATIVE_API_KEY` | — | Your AINative API key (required). |
| `AINATIVE_API_URL` | `https://api.ainative.studio` | ZeroDB API base. |
| `OPENCODE_MEMORY_NAMESPACE` | `opencode` | Scope memories per-project/agent. |

## License

MIT
