magic-context

让AI智能体拥有无限记忆，一个会话干到底

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署智能体 🍴 复刻 150 🐛 待处理 53 👀 关注 7

GitHub ↗

GitHub 星标 ★ 2482

维护状态活跃

是否开源开源

定价模式 🏷️完全免费开源项目，MIT许可证，完全免费，可自行部署使用。

项目预览

magic-context 项目界面预览图 — 图片来源：GitHub 官方仓库名片

项目数据

分类智能体

开发团队cortexkit

GitHubhttps://github.com/cortexkit/magic-context

定价模式🏷️完全免费

价格说明开源项目，MIT许可证，完全免费，可自行部署使用。

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议MIT

主要语言TypeScript

技术栈/模型agent-framework,agent-memory,ai,ai-agents,ai-context,ai-memory,cache-aware,context-engineering,context-management,langchain,memory,opencode,pi-coding-agent

GitHub 星标★ 2482

上线时间2026-03-26 00:00:00

代码更新2026-11-08

仓库体积174.2 MB

本站数据更新2026-11-08

维护状态活跃

收录时间2026-08-09

浏览次数4

项目介绍

magic-context 是一个面向编码智能体的上下文管理工具，旨在解决 AI 智能体在长会话中上下文有限、记忆混乱的问题。它提供无界上下文和自管理记忆，让智能体在一个会话中持续工作，无需频繁重置。核心能力包括自动记忆分层、缓存感知的上下文压缩、以及与主流智能体框架（如 LangChain）的集成。通过模拟海马体的功能，它帮助智能体记住关键信息，遗忘冗余内容，从而提升长任务的稳定性和效率。项目采用 TypeScript 编写，属于 CortexKit 生态，目前处于成长阶段，适合需要长期记忆和复杂任务处理的 AI 应用开发者。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 2482

技术标签

agent-framework agent-memory ai ai-agents ai-memory

使用教程

难度：入门约 10 分钟部署方式：命令行工具 6 步

环境要求

Node.js 环境（能执行 npx 命令）
已安装至少一个受支持的 harness：OpenCode、Pi 或 OMP
一个真实可用的模型标识 provider/model-id
网络可访问 npm registry 与 GitHub raw 资源

安装与启动步骤

1macOS/Linux 运行向导

一键运行交互式安装向导，自动检测已装的 harness、添加插件并关闭内置压缩。
```
curl -fsSL https://raw.githubusercontent.com/cortexkit/magic-context/master/scripts/install.sh | bash
```
2Windows 运行向导

在 PowerShell 中执行安装脚本，效果与 macOS/Linux 脚本一致。
```
irm https://raw.githubusercontent.com/cortexkit/magic-context/master/scripts/install.ps1 | iex
```
3任意系统直接运行

不执行安装脚本时，可用 npx 直接启动同款交互式安装向导。
```
npx @cortexkit/magic-context@latest setup
```
4指定目标 harness

同时装了多个 harness 时，用 --harness 指定要配置哪一个（opencode、pi 或 omp）。
```
npx @cortexkit/magic-context@latest setup --harness opencode
```
5手动配置 OpenCode

无法跑向导时，在 opencode.jsonc 中加入 plugin 条目，并把 compaction 的 auto 与 prune 设为 false。
6配置 historian 模型

创建 magic-context.jsonc，填入 historian.opencode.model，取值必须是真实的 provider/model-id。

关键配置

配置项	必填	说明	示例
`plugin`	是	在 opencode.jsonc 中注册 magic-context 插件	`["@cortexkit/opencode-magic-context@latest"]`
`compaction.auto`	是	关闭宿主自动压缩，避免与 Magic Context 冲突	`false`
`compaction.prune`	是	关闭宿主压缩裁剪	`false`
`historian.opencode.model`	是	指定 historian 使用的模型，缺失会导致历史摘要失败	`provider/model-id`
`embedding`	否	省略则用本地 Xenova/all-MiniLM-L6-v2；关闭会失去语义检索	`false`
`dreamer`	否	控制周期性记忆整合，省略即关闭该功能	`provider/model-id`