Which files can crystl create inside an existing project?

Opening a gem can involve these integration files, depending on your settings and the files already present:

  • .crystl/.gitignore, which keeps crystl runtime state from dirtying Git status.
  • .mcp.json, when enabled MCP defaults exist and the project does not already have that file.
  • .claude/settings.local.json, when MCP auto-trust is enabled and the project has MCP servers.
  • AGENTS.md and CLAUDE.md, when CLI instruction injection and creation of missing agent docs are enabled.

Other files under .crystl/ are created when you use features such as history, worktrees, quest, local heroes, or per-gem settings. See Settings, agent files, and MCP servers.