MemoryOS
Your Claude Code setup has 45 things that could be better. This finds them in 2 seconds.
Open-source context engineering scanner for Claude Code
在45个检查层和3个维度上对您的克劳德代码设置进行评分。返回具有上下文工程模式映射的自适应报告、具有时间估计的优先级修复和HTML仪表板。免费工具在本地运行,无需网络调用。付费工具解锁了进度跟踪、上下文分析、对话导入和AI驱动的升级。
______________________________________________________________________
安装
一个命令设置
npx @iwo-szapar/second-brain-health-check setup互动式入职培训(约2分钟):
- 询问您的API密钥(或跳过免费层)
- 用Claude代码配置MCP服务器
- 询问你的角色、经验和目标
- 运行第一次健康检查并打开仪表板
手动MCP设置
claude mcp add second-brain-health-check -- npx @iwo-szapar/second-brain-health-check然后问克劳德:“对我的项目进行健康检查。”
______________________________________________________________________
工具
免费工具
不需要API密钥。在本地运行,无网络呼叫。
check_health
完整的45层扫描,涵盖设置质量、使用活动和AI流畅性。根据你大脑的成熟度调整报告。
> Run a health check
> Check my setup health in quick mode
> Run health check in Spanish参数:
| 参数 | 默认值 | 选项 |
|---|---|---|
path | 当前目录 | 项目根目录的路径 |
mode | full | full (45层), quick (仅约100ms检测), manifest (完整+YAML输出) |
language | en | en, es, de, fr, pl, pt, ja, ko, zh, it, nl, ru, tr, ar |
workspace_type | -- | solo, team, enterprise |
use_case | -- | development, content, operations, research, mixed |
get_fix_suggestions
针对你最薄弱的领域制定优先行动计划。每个修复都包括时间估计和点值。
> What should I fix first in my setup?
> Give me fix suggestions focused on setup quality参数:
| 参数 | 默认值 | 选项 |
|---|---|---|
path | 当前目录 | 项目根目录的路径 |
focus | auto | auto (挑选最弱的), setup, usage, fluency |
language | en | 与check_health相同 |
generate_dashboard
具有分数可视化、CE雷达图和引导修复的独立HTML仪表板。在浏览器中打开。
> Generate a health check dashboard
> Generate dashboard and save to ~/reports/brain.html参数:
| 参数 | 默认值 | 选项 |
|---|---|---|
path | 当前目录 | 项目根目录的路径 |
output | health-check-report.html | 输出文件路径 |
generate_pdf
通过无头Chrome浏览器生成PDF报告。需要安装Chrome或Chromium。
> Generate a PDF health check report参数:
| 参数 | 默认值 | 选项 |
|---|---|---|
project_path | *(必填)* | 项目的绝对路径 |
______________________________________________________________________
付费工具
需要API密钥。集 SBK_TOKEN 在您的环境中或跑步 setup 配置。
weekly_pulse
随着时间的推移跟踪进度。显示分数增量、CE模式趋势、条纹检测和有针对性的建议。
> Show my weekly pulse
> Show my progress over the last 30 days参数:
| 参数 | 默认值 | 选项 |
|---|---|---|
period | since_last | since_last, 7d, 30d |
path | 当前目录 | 项目根目录的路径 |
context_pressure
分析固定开销(CLAUDE.md、MEMORY.md、知识文件、MCP定义、技能、钩子和设置)消耗了20万令牌上下文窗口的多少。
> Check my context pressure
> How much of my context window am I using?参数:
| 参数 | 默认值 | 选项 |
|---|---|---|
path | 当前目录 | 项目根目录的路径 |
audit_config
审核您的配置,查看是否存在死引用、冲突、安全问题、未使用项和性能问题。
> Audit my config
> Run a security audit on my setup参数:
| 参数 | 默认值 | 选项 |
|---|---|---|
path | 当前目录 | 项目根目录的路径 |
check_categories | 全部5 | references, conflicts, security, unused, performance |
每个类别检查的内容:
- 参考文献 --CLAUDE.md中的死文件路径,缺少挂钩脚本
- 冲突 --重复的CLAUDE.md文件、重叠的MCP服务器、不匹配的挂钩
- 安全 --
.env在.gitignore,配置文件中的API密钥模式,通配符权限 - 未使用的 --会话日志中零调用的技能
- 演出 --CLAUDE.md过大(>300行),MEMORY.md(>180行),MCP工具过多(>30)
import_context
从ChatGPT导入对话历史记录,或将Claude导出到有组织的内存文件中。先扫描以预览,然后导入以创建文件。
> Scan my ChatGPT export at ~/Downloads/conversations.json
> Import my ChatGPT conversations, only coding-related ones from 2025参数:
| 参数 | 默认值 | 选项 |
|---|---|---|
source_type | *(必填)* | chatgpt_export (对话.json)或 claude_export (目录) |
source_path | *(必填)* | 导出文件或目录的路径 |
mode | scan | scan (仅预览)或 import (写入文件) |
output_dir | memory/imported/ | 在哪里写入导入的文件 |
max_conversations | 无限制 | 限制已处理的对话 |
min_messages | 3 | 跳过简短对话 |
date_after | -- | ISO日期过滤器(例如。 2024-01-01) |
date_before | -- | ISO日期过滤器 |
categories | 全部 | coding, writing, research, planning, data, creative, operations |
merge_existing | false | 如果为真,请写信给 memory/semantic/ 相反 |
language | en | 输出语言 |
upgrade_brain
识别设置中丢失和过时的文件,并生成个性化升级。在本地运行运行运行状况检查和清点,然后调用Factory API进行模板匹配和个性化设置。需要 SBK_TOKEN env-var(MemoryOS用户权益)。
> Upgrade my brain
> Show me what files I'm missing (dry run)
> Upgrade brain, high impact only参数:
| 参数 | 默认值 | 选项 |
|---|---|---|
path | 当前目录 | 项目根目录的路径 |
high_only | false | 仅显示高影响文件 |
category | 全部 | agent, skill, memory, config, docs |
dry_run | false | 预览差异而不应用 |
______________________________________________________________________
命令行界面
# First-time setup (interactive)
npx @iwo-szapar/second-brain-health-check setup
# Run health check (prints report + opens dashboard)
npx @iwo-szapar/second-brain-health-check
# Scan a specific directory
npx @iwo-szapar/second-brain-health-check /path/to/project
# Text report only (no browser)
npx @iwo-szapar/second-brain-health-check --no-open
# Generate PDF report
npx @iwo-szapar/second-brain-health-check --pdf______________________________________________________________________
它衡量什么
三维。45个检查层。~459个原始点,每个标准化为/100。
SETUP QUALITY 32 layers ~284 pts
A (85%+) | B (70%+) | C (50%+) | D (30%+) | F ( 快速工程优化了单个LLM呼叫。
> 上下文工程优化了围绕这些调用的持久系统--
> 塑造每个会话的文件、钩子、记忆和技能。
您的CLAUDE.md, `.claude/` 目录、技能、钩子、内存文件、MCP服务器和规划工件形成了一个持久的上下文层。MemoryOS对该层进行评分,而不是对提示进行评分。
______________________________________________________________________
## 故障排除
### 从以下位置迁移 `@iwo-szapar/memoryos`
旧包裹 `@iwo-szapar/memoryos` 已弃用。如果你看到 `Memoryos [tool_name]` (大写M)在您的工具输出中,您使用的是旧软件包。
**克劳德代码CLI:**
claude mcp remove memoryos claude mcp remove second-brain-health-check npm cache clean --force claude mcp add second-brain-health-check -- npx @iwo-szapar/second-brain-health-check@latest
**VS代码(Claude扩展名):**
VS代码扩展名为 `.mcp.json` 在项目根目录中(不是 `.claude.json`).创建或编辑 `.mcp.json`:
{ "mcpServers": { "second-brain-health-check": { "type": "stdio", "command": "npx", "args": ["@iwo-szapar/second-brain-health-check@latest"], "env": { "SBK_TOKEN": "your_sbk_token_here" } } } }
**克劳德桌面/协作:**
Claude Desktop将MCP配置存储在单独的文件中(不是 `.claude.json` 或 `.mcp.json`):
- **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
- **窗户:** `%APPDATA%\Claude\claude_desktop_config.json`
- **Linux:** `~/.config/Claude/claude_desktop_config.json`
打开那个文件,找到旧的 `"memoryos"` 进入下 `"mcpServers"`,并替换为:
"second-brain-health-check": { "command": "npx", "args": ["@iwo-szapar/second-brain-health-check@latest"], "env": { "SBK_TOKEN": "your_sbk_token_here" } }
然后重新启动应用程序。
**哪个配置文件做什么:**
|客户端|配置文件|作用域|
|:-------|:-----------|:------|
|克劳德代码CLI| `.claude.json` |每个项目(在项目根中)或全局(`~/.claude.json`) |
|VS代码扩展| `.mcp.json` |每个项目(以项目根为单位)|
|克劳德桌面/协作| `claude_desktop_config.json` |全局(见上面的路径)|
### Windows:路径错误
如果你看到 `Path "c:\Users\..." is outside the home directory`,驱动器号大小写不匹配。已在v0.17.2+版本中修复。更新为:
npm cache clean --force
然后重新运行该工具。服务器在下次调用时获取最新版本。
### 固定 npx 缓存
如果更新后修复未生效,则npx可能正在提供缓存的旧版本。标志:错误消息参考 `UPGRADE_BRAIN_API_KEY` (在v0.17.2中删除),或工具输出缺少 `[MemoryOS vX.Y.Z]` 版本前缀。
npm cache clean --force npx clear-npx-cache
### 如何检查您的版本
每个工具响应都始于 `[MemoryOS v0.17.5]` (或您安装的版本)。如果您没有看到此前缀,则表示您使用的是v0.17.4或更旧版本。
______________________________________________________________________
[记忆](https://www.iwoszapar.com/memory-os) 通过 [伊沃 沙帕尔](https://www.iwoszapar.com).MIT许可证。