Jinni

Jinni 项目旨在为开发者提供高效的文件上下文管理能力，通过自定义根目录和规则配置，精准控制哪些文件被纳入上下文，避免不必要的大文件干扰。支持命令行与 MCP 客户端配置，具备动态规则解析与上下文大小错误提示功能。

核心功能

• 灵活的项目根目录设置，支持自定义路径
• 支持覆盖规则与动态上下文规则（基于 .contextfiles）
• 自动识别并处理上下文大小超限问题，提供 10 个最大文件列表
• 可通过命令行或 MCP 客户端配置规则与大小限制

安装方法

文档未提供明确安装步骤，建议通过 GitHub 仓库克隆后使用 Python 运行服务模块。

python -m jinni.serve serve --root /path/to/your/project_root

使用方法

1. 指定项目根目录：使用 `--root` 参数或 MCP 客户端配置
2. 配置规则：在项目中创建 `.contextfiles` 文件，定义包含/排除规则
3. 处理上下文超限：根据错误提示审查大文件，调整规则或增加大小限制
4. 集成 MCP：在 Cursor 等编辑器中通过 `rules` 属性配置动态上下文规则

# 示例：.contextfiles 文件内容
!*.log
!large_data_files/
!*.bin
!*.zip
!*.mp4

使用 `jinni usage` 查看帮助文档或配置详情。