AI开发上下文管理工具

Context Anchor是一个基于Git的AI辅助开发上下文管理工具,通过版本化的Markdown文件记录项目决策和约束条件,实现跨会话和工具的上下文共享。

  • by DevDario
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 DevDario/context-anchor

使用说明

上下文锚点

用于AI辅助开发的Git本地上下文层。

LLMs忘记了。每一次新的会话,每一次工具切换——你都要重新解释堆栈、决策和约束。Context Anchor将这些知识具体化为任何LLM都可以随时读取的版本化markdown文件。

建立在 MCP协议.适用于Claude Code、Cursor和任何兼容MCP的客户端。


的问题

当你在多个会话或工具中使用人工智能时,上下文会受到侵蚀。模型记得 什么 你决定了,但忘记了 为什么.你让谈话持续的时间比你应该的要长——不是因为它们富有成效,而是因为结束它们意味着失去一切。

Context Anchor通过将上下文视为基础设施而不是对话来解决这个问题。


运作原理

.context/
  project.md        ← stack, principles, conventions (stable)
  features/
    auth.md         ← decisions, constraints, open questions, state
    payments.md
  history/          ← automatic snapshots on every git commit

您的MCP兼容编辑器调用 get_context 在每项任务开始时。LLM在几秒钟内获得完整的项目+功能上下文——每个会话都是热启动。


安装

npm install -g @context-anchor/cli

或者使用pnpm:

pnpm add -g @context-anchor/cli

用法

# Initialize in your project
ctx init --interactive

# Create a feature context doc
ctx new-feature "user auth"

# Start the MCP server
ctx serve

# Check status
ctx status

# Export context for a specific LLM
ctx export claude
ctx export openai --feature user-auth
ctx export cursor --copy

# Manual snapshot
ctx snapshot

# Install git hook (auto-snapshot on commit)
ctx install-hook

MCP工具

曾经 ctx serve 如果正在运行,您的编辑器可以访问:

工具 说明
get_context 获取项目+功能上下文。在每项任务开始时打电话。
list_features 列出所有具有状态的功能文档。
update_feature 做出决定后记录下来。
export_context 导出针对特定LLM格式化的上下文。

连接到编辑器

光标

添加到光标MCP配置(~/.cursor/mcp.json):

{
  "mcpServers": {
    "context-anchor": {
      "command": "node",
      "args": ["/path/to/context-anchor/packages/server/dist/index.js"]
    }
  }
}

克劳德代码

{
  "mcpServers": {
    "context-anchor": {
      "command": "ctx",
      "args": ["serve"]
    }
  }
}

项目上下文格式

.context/project.md --编辑一次,很少更新:

# My Project

## Stack
- Next.js 14, Node.js, PostgreSQL

## Principles
- Mobile-first, offline-capable
- Multi-tenant: always scope queries by tenantId

## Conventions
- Functional services, no classes
- Result pattern for error handling

.context/features/auth.md --每节课的进展情况:

# Feature: Auth

## Decisions
| Decision | Reason | Rejected |
|---|---|---|
| JWT stateless | No session store needed | Sessions (infra overhead) |

## Constraints
- Tokens expire in 7 days
- Refresh tokens stored in httpOnly cookie

## Open Questions
- [ ] OAuth providers for v2?

## State
- [x] Login + register
- [ ] Password reset

为什么不直接使用Cursor的内存/Claude项目呢?

这些工具在项目级别运行——它们记住你的堆栈,而不是你的功能级别决策。他们不抓 为什么 你选择了一种方法而不是另一种方法,选择了被拒绝的方法,或者选择了仍然开放的方法。他们被锁定在一个工具上。

Context Anchor是可移植的、可版本化的,适用于您使用的每个LLM。


路线图

  • [x] MCP服务器(获取、列表、更新、导出)
  • [x] CLI(初始化、服务、状态、新功能、快照、导出)
  • [x] Git钩子用于自动快照
  • [x] 多LLM格式化器(Claude、OpenAI、Gemini、Cursor)
  • [ ] diff 快照之间
  • []团队同步(跨开发人员共享上下文)
  • []Web仪表板
  • []VS代码扩展名

建于

  • MCP-SDK
  • TypeScript、pnpm工作区

许可证

麻省理工学院