@xelauvas/xela-cli 0.2.1 → 0.2.3

package/README.md

@@ -1,27 +1,32 @@
 # Xela CLI
 
-AI coding assistant that works with **any model** — free or paid. Use OpenRouter, Groq, Ollama, DeepSeek, OpenAI, and more. One tool, any brain.
+[![npm](https://img.shields.io/npm/v/@xelauvas/xela-cli)](https://www.npmjs.com/package/@xelauvas/xela-cli)
+[![GitHub stars](https://img.shields.io/github/stars/xelauvas/codeclau?style=social)](https://github.com/xelauvas/codeclau)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+
+**Free AI coding assistant for your terminal.** Works with any model — OpenRouter, Groq, Ollama, DeepSeek, OpenAI, and more. Like Cursor/Claude Code, but free and open source.
 
 ```
- ▐▛███▜▌   Xela CLI
-▝▜█████▛▘  AI coding assistant
-  ▘▘ ▝▝    powered by any model
+╲  ╳  ╱   Xela
+╱  ╳  ╲   AI coding assistant
+  XELA    powered by any model
 ```
 
 ## Install
 
-**npm (recommended):**
 ```bash
 npm install -g @xelauvas/xela-cli
 ```
 
-**One-liner:**
+On first run, Xela walks you through setup — pick a provider, paste a key, choose a model. No config files to edit.
+
+**Other install methods:**
+
 ```bash
+# One-liner
 curl -fsSL https://raw.githubusercontent.com/xelauvas/codeclau/main/install.sh | bash
-```
 
-**From source:**
-```bash
+# From source
 git clone https://github.com/xelauvas/codeclau.git /opt/xela
 cd /opt/xela && npm install && npm link
 ```
@@ -29,10 +34,7 @@ cd /opt/xela && npm install && npm link
 ## Quick Start
 
 ```bash
-# First run creates ~/.xela/config — edit it with your API key
-xela
-
-# Interactive mode
+# Interactive setup + launch
 xela
 
 # With a prompt
@@ -41,160 +43,170 @@ xela "fix the login bug in auth.ts"
 # Non-interactive (pipe-friendly)
 xela -p "explain this function"
 
-# Override model on the fly
-xela -m nvidia/nemotron-3-super-120b-a12b:free "review this code"
-```
+# Override model for one session
+xela -m google/gemini-2.5-pro-exp-03-25:free "review this code"
+```
+
+## What It Can Do
+
+- **Edit files** — reads your code, makes changes with your permission
+- **Run commands** — executes shell commands, runs tests, builds projects
+- **Agentic coding** — plans, executes, and iterates on code changes
+- **Multi-file refactoring** — rename, restructure, migrate across your codebase
+- **Web search** — looks up docs, APIs, error messages
+- **MCP support** — extensible via Model Context Protocol servers
+- **Project memory** — run `/init` to create `XELA.md` with project instructions
+- **Auto mode** — let Xela handle permissions automatically for long tasks
+
+## Slash Commands
+
+| Command | Description |
+|---|---|
+| `/init` | Create a `XELA.md` file with project instructions |
+| `/model` | Switch model |
+| `/config` | Open settings |
+| `/help` | Show help |
+| `/clear` | Clear conversation |
+| `/compact` | Compress conversation to save context |
+| `/cost` | Show token usage |
+| `/mcp` | Manage MCP servers |
+
+## Keyboard Shortcuts
+
+| Key | Action |
+|---|---|
+| `Enter` | Submit prompt |
+| `Escape` | Cancel current request |
+| `Ctrl+C` | Exit |
+| `Tab` | Accept autocomplete |
+| `Shift+Tab` | Toggle auto mode |
+| `Up/Down` | Navigate history |
 
 ## Free Providers
 
-You don't need to pay anything to use Xela. Here are free options:
-
-### OpenRouter (Free Models)
-Sign up at [openrouter.ai](https://openrouter.ai) — no credit card needed.
-
-```bash
-# ~/.xela/config
-XELA_PROVIDER=openrouter
-OPENAI_API_KEY=sk-or-your-key
-OPENAI_MODEL=qwen/qwen3.6-plus-preview:free
-```
+You don't need to pay anything. Here are free options:
 
-Free models available:
-| Model | ID | Context |
-|---|---|---|
-| Qwen 3.6 Plus | `qwen/qwen3.6-plus-preview:free` | 1M |
-| Nemotron 3 Super 120B | `nvidia/nemotron-3-super-120b-a12b:free` | 262K |
-| Step 3.5 Flash | `stepfun/step-3.5-flash:free` | 256K |
-| Nemotron 3 Nano | `nvidia/nemotron-3-nano-30b-a3b:free` | 256K |
+### OpenRouter (recommended)
+Sign up at [openrouter.ai/keys](https://openrouter.ai/keys) — no credit card needed.
 
-### Groq (Free Tier)
-Sign up at [console.groq.com](https://console.groq.com) — blazing fast inference.
+Available free models:
+| Model | ID |
+|---|---|
+| Qwen 3.6 Plus (1M context) | `qwen/qwen3.6-plus-preview:free` |
+| DeepSeek Chat V3 | `deepseek/deepseek-chat-v3-0324:free` |
+| Gemini 2.5 Pro | `google/gemini-2.5-pro-exp-03-25:free` |
+| Llama 4 Maverick | `meta-llama/llama-4-maverick:free` |
+| Nemotron Ultra 253B | `nvidia/llama-3.1-nemotron-ultra-253b:free` |
 
-```bash
-# ~/.xela/config
-XELA_PROVIDER=groq
-OPENAI_API_KEY=gsk_your-key
-OPENAI_MODEL=qwen-qwq-32b
-```
+### Groq (free tier)
+Sign up at [console.groq.com/keys](https://console.groq.com/keys) — blazing fast inference.
 
-### Ollama (Local, Free Forever)
-Install from [ollama.com](https://ollama.com) — runs on your machine.
+### Ollama (local, free forever)
+Install from [ollama.com](https://ollama.com) — runs on your machine, fully private.
 
 ```bash
 ollama pull qwen2.5-coder:7b
-
-# ~/.xela/config
-XELA_PROVIDER=ollama
-OPENAI_API_KEY=ollama
-OPENAI_MODEL=qwen2.5-coder:7b
+# Then pick "ollama" as provider during xela setup
 ```
 
-## Paid Providers
+### Other free tiers
+- **Cerebras** — fast inference, free tier
+- **SambaNova** — free tier available
 
-For better quality and speed:
+## Paid Providers
 
-### OpenRouter (Paid Models)
-```bash
-XELA_PROVIDER=openrouter
-OPENAI_API_KEY=sk-or-your-key
-OPENAI_MODEL=openai/gpt-5.3-codex          # $0.00175/M input
-# OPENAI_MODEL=anthropic/claude-opus-4.6    # $0.005/M input
-# OPENAI_MODEL=google/gemini-3.1-pro-preview # $0.002/M input
-```
+For better quality and higher rate limits:
 
-### DeepSeek
-```bash
-XELA_PROVIDER=deepseek
-OPENAI_API_KEY=sk-your-key
-OPENAI_MODEL=deepseek-chat
-```
-
-### OpenAI Direct
-```bash
-XELA_PROVIDER=openai
-OPENAI_API_KEY=sk-your-key
-OPENAI_MODEL=gpt-4o
-```
+| Provider | Setup |
+|---|---|
+| **DeepSeek** | [platform.deepseek.com/api_keys](https://platform.deepseek.com/api_keys) — very cheap |
+| **OpenAI** | [platform.openai.com/api-keys](https://platform.openai.com/api-keys) |
+| **OpenRouter** (paid models) | Same key, just pick a paid model |
 
 ## Configuration
 
-Config file: `~/.xela/config` (created on first run)
+Config is stored at `~/.xela/config.json` (created during first-run setup).
 
-```bash
-# ~/.xela/config
-XELA_PROVIDER=openrouter
-OPENAI_API_KEY=sk-or-your-key-here
-OPENAI_MODEL=qwen/qwen3.6-plus-preview:free
-# OPENAI_BASE_URL=  # auto-detected from provider
+```json
+{
+  "provider": "openrouter",
+  "apiKey": "sk-or-v1-...",
+  "model": "qwen/qwen3.6-plus-preview:free",
+  "baseUrl": ""
+}
 ```
 
-### Supported Providers
+### Re-run setup
 
-| Provider | `XELA_PROVIDER` | Key Prefix | Free? |
-|---|---|---|---|
-| OpenRouter | `openrouter` | `sk-or-` | Free models available |
-| Groq | `groq` | `gsk_` | Free tier |
-| Ollama | `ollama` | `ollama` | Free (local) |
-| DeepSeek | `deepseek` | `sk-` | Cheap |
-| OpenAI | `openai` | `sk-` | Paid |
-| Cerebras | `cerebras` | — | Free tier |
-| SambaNova | `sambanova` | — | Free tier |
+```bash
+rm ~/.xela/config.json && xela
+```
 
-### Model Override
+### Change model
 
 ```bash
-# Override for a single session
-xela -m openai/gpt-5.4-pro "architect a microservice"
+# Edit config directly
+nano ~/.xela/config.json
 
-# Or set in config permanently
-nano ~/.xela/config
+# Or override per-session
+xela -m model-id
 ```
 
-## Features
+### Supported Providers
 
-- **Multi-provider** — Switch between any OpenAI-compatible API
-- **Auto-detection** — Detects provider from API key prefix
-- **Free by default** — Works with free models out of the box
-- **Full CLI** — Interactive REPL, non-interactive mode, piping support
-- **Tool use** — File editing, bash commands, web search, and more
-- **Agentic coding** — Plans, executes, and iterates on code changes
-- **MCP support** — Extensible via Model Context Protocol servers
+| Provider | Default Model | Free? |
+|---|---|---|
+| OpenRouter | `qwen/qwen3.6-plus-preview:free` | Free models available |
+| Groq | `qwen-qwq-32b` | Free tier |
+| Ollama | `qwen2.5-coder:7b` | Free (local) |
+| DeepSeek | `deepseek-chat` | Cheap |
+| OpenAI | `gpt-4o` | Paid |
+| Cerebras | `llama-3.3-70b` | Free tier |
+| SambaNova | `Meta-Llama-3.3-70B-Instruct` | Free tier |
 
 ## Self-Hosting Models
 
-For privacy or unlimited usage, run models locally:
+For privacy or unlimited usage, run models locally with Ollama:
 
-### Small Server (16GB RAM, no GPU)
 ```bash
+# Small (16GB RAM, no GPU) — ~10-30 tok/s
 ollama pull qwen2.5-coder:3b
-# ~10-30 tokens/sec on CPU
-```
 
-### GPU Server (24GB+ VRAM)
-```bash
+# GPU (24GB+ VRAM) — ~100 tok/s
 ollama pull qwen2.5-coder:32b
-# 100+ tokens/sec
+
+# Multi-GPU — full power
+ollama pull deepseek-v3.2
 ```
 
-### Multi-GPU Server
+## Project Instructions (XELA.md)
+
+Run `/init` inside any project to generate a `XELA.md` file. This file tells Xela about your project — build commands, architecture, conventions. It's loaded automatically every session.
+
 ```bash
-ollama pull deepseek-v3.2
-# Full power
+cd my-project
+xela
+# then type /init
 ```
 
+Xela also reads `XELA.local.md` for personal project instructions (add it to `.gitignore`).
+
 ## Uninstall
 
 ```bash
-# npm install
+# Remove CLI
 npm uninstall -g @xelauvas/xela-cli
 
-# curl install
-curl -fsSL https://raw.githubusercontent.com/xelauvas/codeclau/main/uninstall.sh | bash
-
-# Config (optional)
+# Remove config (optional)
 rm -rf ~/.xela
 ```
 
+## Links
+
+- **GitHub**: [github.com/xelauvas/codeclau](https://github.com/xelauvas/codeclau)
+- **npm**: [@xelauvas/xela-cli](https://www.npmjs.com/package/@xelauvas/xela-cli)
+- **Issues**: [github.com/xelauvas/codeclau/issues](https://github.com/xelauvas/codeclau/issues)
+
 ## License
 
 MIT

package/bin/xela.js

@@ -165,6 +165,24 @@ for (let i = 0; i < args.length; i++) {
   }
 }
 
+// Show star prompt after first few uses
+const STAR_FILE = join(XELA_HOME, '.star-shown');
+const USAGE_FILE = join(XELA_HOME, '.usage-count');
+try {
+  let count = 0;
+  try { count = parseInt(readFileSync(USAGE_FILE, 'utf-8')) || 0; } catch {}
+  count++;
+  writeFileSync(USAGE_FILE, String(count));
+  if (count === 3 && !existsSync(STAR_FILE)) {
+    console.log('');
+    console.log('  \x1b[36m╲  ╳  ╱\x1b[0m  Enjoying Xela? Give it a star!');
+    console.log('  \x1b[36m╱  ╳  ╲\x1b[0m  \x1b[4mhttps://github.com/xelauvas/codeclau\x1b[0m');
+    console.log('  \x1b[36m  XELA \x1b[0m  It helps others discover it too.');
+    console.log('');
+    writeFileSync(STAR_FILE, '1');
+  }
+} catch {}
+
 // Launch node with the TSX loader shim
 try {
   execFileSync(process.execPath, [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xelauvas/xela-cli",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "description": "Xela — AI coding assistant powered by any model (OpenRouter, Groq, Ollama, DeepSeek, OpenAI)",
   "author": "xelauvas",
   "license": "MIT",
@@ -20,7 +20,7 @@
   ],
   "scripts": {
     "start": "node --import ./src/_shims/register.js ./src/entrypoints/cli.tsx",
-    "postinstall": "echo '\\n  Xela installed! Run: xela\\n  Config: ~/.xela/config\\n'"
+    "postinstall": "echo '\\n  \\x1b[36m╲  ╳  ╱\\x1b[0m  Xela installed!\\n  \\x1b[36m╱  ╳  ╲\\x1b[0m  Run: xela\\n  \\x1b[36m  XELA \\x1b[0m  Star: github.com/xelauvas/codeclau\\n'"
   },
   "dependencies": {
     "@alcalzone/ansi-tokenize": "^0.3.0",

package/src/commands/init.ts

@@ -3,15 +3,15 @@ import type { Command } from '../commands.js'
 import { maybeMarkProjectOnboardingComplete } from '../projectOnboardingState.js'
 import { isEnvTruthy } from '../utils/envUtils.js'
 
-const OLD_INIT_PROMPT = `Please analyze this codebase and create a CLAUDE.md file, which will be given to future instances of Claude Code to operate in this repository.
+const OLD_INIT_PROMPT = `Please analyze this codebase and create a XELA.md file, which will be given to future instances of Xela to operate in this repository.
 
 What to add:
 1. Commands that will be commonly used, such as how to build, lint, and run tests. Include the necessary commands to develop in this codebase, such as how to run a single test.
 2. High-level code architecture and structure so that future instances can be productive more quickly. Focus on the "big picture" architecture that requires reading multiple files to understand.
 
 Usage notes:
-- If there's already a CLAUDE.md, suggest improvements to it.
-- When you make the initial CLAUDE.md, do not repeat yourself and do not include obvious instructions like "Provide helpful error messages to users", "Write unit tests for all new utilities", "Never include sensitive information (API keys, tokens) in code or commits".
+- If there's already a XELA.md, suggest improvements to it.
+- When you make the initial XELA.md, do not repeat yourself and do not include obvious instructions like "Provide helpful error messages to users", "Write unit tests for all new utilities", "Never include sensitive information (API keys, tokens) in code or commits".
 - Avoid listing every component or file structure that can be easily discovered.
 - Don't include generic development practices.
 - If there are Cursor rules (in .cursor/rules/ or .cursorrules) or Copilot rules (in .github/copilot-instructions.md), make sure to include the important parts.
@@ -20,30 +20,30 @@ Usage notes:
 - Be sure to prefix the file with the following text:
 
 \`\`\`
-# CLAUDE.md
+# XELA.md
 
-This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+This file provides guidance to Xela (claude.ai/code) when working with code in this repository.
 \`\`\``
 
-const NEW_INIT_PROMPT = `Set up a minimal CLAUDE.md (and optionally skills and hooks) for this repo. CLAUDE.md is loaded into every Claude Code session, so it must be concise — only include what Claude would get wrong without it.
+const NEW_INIT_PROMPT = `Set up a minimal XELA.md (and optionally skills and hooks) for this repo. XELA.md is loaded into every Xela session, so it must be concise — only include what Claude would get wrong without it.
 
 ## Phase 1: Ask what to set up
 
 Use AskUserQuestion to find out what the user wants:
 
-- "Which CLAUDE.md files should /init set up?"
-  Options: "Project CLAUDE.md" | "Personal CLAUDE.local.md" | "Both project + personal"
+- "Which XELA.md files should /init set up?"
+  Options: "Project XELA.md" | "Personal XELA.local.md" | "Both project + personal"
   Description for project: "Team-shared instructions checked into source control — architecture, coding standards, common workflows."
   Description for personal: "Your private preferences for this project (gitignored, not shared) — your role, sandbox URLs, preferred test data, workflow quirks."
 
 - "Also set up skills and hooks?"
-  Options: "Skills + hooks" | "Skills only" | "Hooks only" | "Neither, just CLAUDE.md"
+  Options: "Skills + hooks" | "Skills only" | "Hooks only" | "Neither, just XELA.md"
   Description for skills: "On-demand capabilities you or Claude invoke with \`/skill-name\` — good for repeatable workflows and reference knowledge."
   Description for hooks: "Deterministic shell commands that run on tool events (e.g., format after every edit). Claude can't skip them."
 
 ## Phase 2: Explore the codebase
 
-Launch a subagent to survey the codebase, and ask it to read key files to understand the project: manifest files (package.json, Cargo.toml, pyproject.toml, go.mod, pom.xml, etc.), README, Makefile/build configs, CI config, existing CLAUDE.md, .claude/rules/, AGENTS.md, .cursor/rules or .cursorrules, .github/copilot-instructions.md, .windsurfrules, .clinerules, .mcp.json.
+Launch a subagent to survey the codebase, and ask it to read key files to understand the project: manifest files (package.json, Cargo.toml, pyproject.toml, go.mod, pom.xml, etc.), README, Makefile/build configs, CI config, existing XELA.md, .claude/rules/, AGENTS.md, .cursor/rules or .cursorrules, .github/copilot-instructions.md, .windsurfrules, .clinerules, .mcp.json.
 
 Detect:
 - Build, test, and lint commands (especially non-standard ones)
@@ -53,30 +53,30 @@ Detect:
 - Non-obvious gotchas, required env vars, or workflow quirks
 - Existing .claude/skills/ and .claude/rules/ directories
 - Formatter configuration (prettier, biome, ruff, black, gofmt, rustfmt, or a unified format script like \`npm run format\` / \`make fmt\`)
-- Git worktree usage: run \`git worktree list\` to check if this repo has multiple worktrees (only relevant if the user wants a personal CLAUDE.local.md)
+- Git worktree usage: run \`git worktree list\` to check if this repo has multiple worktrees (only relevant if the user wants a personal XELA.local.md)
 
 Note what you could NOT figure out from code alone — these become interview questions.
 
 ## Phase 3: Fill in the gaps
 
-Use AskUserQuestion to gather what you still need to write good CLAUDE.md files and skills. Ask only things the code can't answer.
+Use AskUserQuestion to gather what you still need to write good XELA.md files and skills. Ask only things the code can't answer.
 
-If the user chose project CLAUDE.md or both: ask about codebase practices — non-obvious commands, gotchas, branch/PR conventions, required env setup, testing quirks. Skip things already in README or obvious from manifest files. Do not mark any options as "recommended" — this is about how their team works, not best practices.
+If the user chose project XELA.md or both: ask about codebase practices — non-obvious commands, gotchas, branch/PR conventions, required env setup, testing quirks. Skip things already in README or obvious from manifest files. Do not mark any options as "recommended" — this is about how their team works, not best practices.
 
-If the user chose personal CLAUDE.local.md or both: ask about them, not the codebase. Do not mark any options as "recommended" — this is about their personal preferences, not best practices. Examples of questions:
+If the user chose personal XELA.local.md or both: ask about them, not the codebase. Do not mark any options as "recommended" — this is about their personal preferences, not best practices. Examples of questions:
   - What's their role on the team? (e.g., "backend engineer", "data scientist", "new hire onboarding")
   - How familiar are they with this codebase and its languages/frameworks? (so Claude can calibrate explanation depth)
   - Do they have personal sandbox URLs, test accounts, API key paths, or local setup details Claude should know?
-  - Only if Phase 2 found multiple git worktrees: ask whether their worktrees are nested inside the main repo (e.g., \`.claude/worktrees/<name>/\`) or siblings/external (e.g., \`../myrepo-feature/\`). If nested, the upward file walk finds the main repo's CLAUDE.local.md automatically — no special handling needed. If sibling/external, the personal content should live in a home-directory file (e.g., \`~/.claude/<project-name>-instructions.md\`) and each worktree gets a one-line CLAUDE.local.md stub that imports it: \`@~/.claude/<project-name>-instructions.md\`. Never put this import in the project CLAUDE.md — that would check a personal reference into the team-shared file.
+  - Only if Phase 2 found multiple git worktrees: ask whether their worktrees are nested inside the main repo (e.g., \`.claude/worktrees/<name>/\`) or siblings/external (e.g., \`../myrepo-feature/\`). If nested, the upward file walk finds the main repo's XELA.local.md automatically — no special handling needed. If sibling/external, the personal content should live in a home-directory file (e.g., \`~/.claude/<project-name>-instructions.md\`) and each worktree gets a one-line XELA.local.md stub that imports it: \`@~/.claude/<project-name>-instructions.md\`. Never put this import in the project XELA.md — that would check a personal reference into the team-shared file.
   - Any communication preferences? (e.g., "be terse", "always explain tradeoffs", "don't summarize at the end")
 
-**Synthesize a proposal from Phase 2 findings** — e.g., format-on-edit if a formatter exists, a \`/verify\` skill if tests exist, a CLAUDE.md note for anything from the gap-fill answers that's a guideline rather than a workflow. For each, pick the artifact type that fits, **constrained by the Phase 1 skills+hooks choice**:
+**Synthesize a proposal from Phase 2 findings** — e.g., format-on-edit if a formatter exists, a \`/verify\` skill if tests exist, a XELA.md note for anything from the gap-fill answers that's a guideline rather than a workflow. For each, pick the artifact type that fits, **constrained by the Phase 1 skills+hooks choice**:
 
   - **Hook** (stricter) — deterministic shell command on a tool event; Claude can't skip it. Fits mechanical, fast, per-edit steps: formatting, linting, running a quick test on the changed file.
   - **Skill** (on-demand) — you or Claude invoke \`/skill-name\` when you want it. Fits workflows that don't belong on every edit: deep verification, session reports, deploys.
-  - **CLAUDE.md note** (looser) — influences Claude's behavior but not enforced. Fits communication/thinking preferences: "plan before coding", "be terse", "explain tradeoffs".
+  - **XELA.md note** (looser) — influences Claude's behavior but not enforced. Fits communication/thinking preferences: "plan before coding", "be terse", "explain tradeoffs".
 
-  **Respect Phase 1's skills+hooks choice as a hard filter**: if the user picked "Skills only", downgrade any hook you'd suggest to a skill or a CLAUDE.md note. If "Hooks only", downgrade skills to hooks (where mechanically possible) or notes. If "Neither", everything becomes a CLAUDE.md note. Never propose an artifact type the user didn't opt into.
+  **Respect Phase 1's skills+hooks choice as a hard filter**: if the user picked "Skills only", downgrade any hook you'd suggest to a skill or a XELA.md note. If "Hooks only", downgrade skills to hooks (where mechanically possible) or notes. If "Neither", everything becomes a XELA.md note. Never propose an artifact type the user didn't opt into.
 
 **Show the proposal via AskUserQuestion's \`preview\` field, not as a separate text message** — the dialog overlays your output, so preceding text is hidden. The \`preview\` field renders markdown in a side-panel (like plan mode); the \`question\` field is plain-text-only. Structure it as:
 
@@ -86,17 +86,17 @@ If the user chose personal CLAUDE.local.md or both: ask about them, not the code
 
     • **Format-on-edit hook** (automatic) — \`ruff format <file>\` via PostToolUse
     • **/verify skill** (on-demand) — \`make lint && make typecheck && make test\`
-    • **CLAUDE.md note** (guideline) — "run lint/typecheck/test before marking done"
+    • **XELA.md note** (guideline) — "run lint/typecheck/test before marking done"
 
   - Option labels stay short ("Looks good", "Drop the hook", "Drop the skill") — the tool auto-adds an "Other" free-text option, so don't add your own catch-all.
 
 **Build the preference queue** from the accepted proposal. Each entry: {type: hook|skill|note, description, target file, any Phase-2-sourced details like the actual test/format command}. Phases 4-7 consume this queue.
 
-## Phase 4: Write CLAUDE.md (if user chose project or both)
+## Phase 4: Write XELA.md (if user chose project or both)
 
-Write a minimal CLAUDE.md at the project root. Every line must pass this test: "Would removing this cause Claude to make mistakes?" If no, cut it.
+Write a minimal XELA.md at the project root. Every line must pass this test: "Would removing this cause Claude to make mistakes?" If no, cut it.
 
-**Consume \`note\` entries from the Phase 3 preference queue whose target is CLAUDE.md** (team-level notes) — add each as a concise line in the most relevant section. These are the behaviors the user wants Claude to follow but didn't need guaranteed (e.g., "propose a plan before implementing", "explain the tradeoffs when refactoring"). Leave personal-targeted notes for Phase 5.
+**Consume \`note\` entries from the Phase 3 preference queue whose target is XELA.md** (team-level notes) — add each as a concise line in the most relevant section. These are the behaviors the user wants Claude to follow but didn't need guaranteed (e.g., "propose a plan before implementing", "explain the tradeoffs when refactoring"). Leave personal-targeted notes for Phase 5.
 
 Include:
 - Build/test/lint commands Claude can't guess (non-standard scripts, flags, or sequences)
@@ -111,7 +111,7 @@ Exclude:
 - File-by-file structure or component lists (Claude can discover these by reading the codebase)
 - Standard language conventions Claude already knows
 - Generic advice ("write clean code", "handle errors")
-- Detailed API docs or long references — use \`@path/to/import\` syntax instead (e.g., \`@docs/api-reference.md\`) to inline content on demand without bloating CLAUDE.md
+- Detailed API docs or long references — use \`@path/to/import\` syntax instead (e.g., \`@docs/api-reference.md\`) to inline content on demand without bloating XELA.md
 - Information that changes frequently — reference the source with \`@path/to/import\` so Claude always reads the current version
 - Long tutorials or walkthroughs (move to a separate file and reference with \`@path/to/import\`, or put in a skill)
 - Commands obvious from manifest files (e.g., standard "npm test", "cargo test", "pytest")
@@ -123,22 +123,22 @@ Do not repeat yourself and do not make up sections like "Common Development Task
 Prefix the file with:
 
 \`\`\`
-# CLAUDE.md
+# XELA.md
 
-This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+This file provides guidance to Xela (claude.ai/code) when working with code in this repository.
 \`\`\`
 
-If CLAUDE.md already exists: read it, propose specific changes as diffs, and explain why each change improves it. Do not silently overwrite.
+If XELA.md already exists: read it, propose specific changes as diffs, and explain why each change improves it. Do not silently overwrite.
 
-For projects with multiple concerns, suggest organizing instructions into \`.claude/rules/\` as separate focused files (e.g., \`code-style.md\`, \`testing.md\`, \`security.md\`). These are loaded automatically alongside CLAUDE.md and can be scoped to specific file paths using \`paths\` frontmatter.
+For projects with multiple concerns, suggest organizing instructions into \`.claude/rules/\` as separate focused files (e.g., \`code-style.md\`, \`testing.md\`, \`security.md\`). These are loaded automatically alongside XELA.md and can be scoped to specific file paths using \`paths\` frontmatter.
 
-For projects with distinct subdirectories (monorepos, multi-module projects, etc.): mention that subdirectory CLAUDE.md files can be added for module-specific instructions (they're loaded automatically when Claude works in those directories). Offer to create them if the user wants.
+For projects with distinct subdirectories (monorepos, multi-module projects, etc.): mention that subdirectory XELA.md files can be added for module-specific instructions (they're loaded automatically when Claude works in those directories). Offer to create them if the user wants.
 
-## Phase 5: Write CLAUDE.local.md (if user chose personal or both)
+## Phase 5: Write XELA.local.md (if user chose personal or both)
 
-Write a minimal CLAUDE.local.md at the project root. This file is automatically loaded alongside CLAUDE.md. After creating it, add \`CLAUDE.local.md\` to the project's .gitignore so it stays private.
+Write a minimal XELA.local.md at the project root. This file is automatically loaded alongside XELA.md. After creating it, add \`XELA.local.md\` to the project's .gitignore so it stays private.
 
-**Consume \`note\` entries from the Phase 3 preference queue whose target is CLAUDE.local.md** (personal-level notes) — add each as a concise line. If the user chose personal-only in Phase 1, this is the sole consumer of note entries.
+**Consume \`note\` entries from the Phase 3 preference queue whose target is XELA.local.md** (personal-level notes) — add each as a concise line. If the user chose personal-only in Phase 1, this is the sole consumer of note entries.
 
 Include:
 - The user's role and familiarity with the codebase (so Claude can calibrate explanations)
@@ -147,9 +147,9 @@ Include:
 
 Keep it short — only include what would make Claude's responses noticeably better for this user.
 
-If Phase 2 found multiple git worktrees and the user confirmed they use sibling/external worktrees (not nested inside the main repo): the upward file walk won't find a single CLAUDE.local.md from all worktrees. Write the actual personal content to \`~/.claude/<project-name>-instructions.md\` and make CLAUDE.local.md a one-line stub that imports it: \`@~/.claude/<project-name>-instructions.md\`. The user can copy this one-line stub to each sibling worktree. Never put this import in the project CLAUDE.md. If worktrees are nested inside the main repo (e.g., \`.claude/worktrees/\`), no special handling is needed — the main repo's CLAUDE.local.md is found automatically.
+If Phase 2 found multiple git worktrees and the user confirmed they use sibling/external worktrees (not nested inside the main repo): the upward file walk won't find a single XELA.local.md from all worktrees. Write the actual personal content to \`~/.claude/<project-name>-instructions.md\` and make XELA.local.md a one-line stub that imports it: \`@~/.claude/<project-name>-instructions.md\`. The user can copy this one-line stub to each sibling worktree. Never put this import in the project XELA.md. If worktrees are nested inside the main repo (e.g., \`.claude/worktrees/\`), no special handling is needed — the main repo's XELA.local.md is found automatically.
 
-If CLAUDE.local.md already exists: read it, propose specific additions, and do not silently overwrite.
+If XELA.local.md already exists: read it, propose specific additions, and do not silently overwrite.
 
 ## Phase 6: Suggest and create skills (if user chose "Skills + hooks" or "Skills only")
 
@@ -183,7 +183,7 @@ Both the user (\`/<skill-name>\`) and Claude can invoke skills by default. For w
 
 ## Phase 7: Suggest additional optimizations
 
-Tell the user you're going to suggest a few additional optimizations now that CLAUDE.md and skills (if chosen) are in place.
+Tell the user you're going to suggest a few additional optimizations now that XELA.md and skills (if chosen) are in place.
 
 Check the environment and ask about each gap you find (use AskUserQuestion):
 
@@ -195,7 +195,7 @@ Check the environment and ask about each gap you find (use AskUserQuestion):
 
   For each hook preference (from the queue or the formatter fallback):
 
-  1. Target file: default based on the Phase 1 CLAUDE.md choice — project → \`.claude/settings.json\` (team-shared, committed); personal → \`.claude/settings.local.json\`. Only ask if the user chose "both" in Phase 1 or the preference is ambiguous. Ask once for all hooks, not per-hook.
+  1. Target file: default based on the Phase 1 XELA.md choice — project → \`.claude/settings.json\` (team-shared, committed); personal → \`.claude/settings.local.json\`. Only ask if the user chose "both" in Phase 1 or the preference is ambiguous. Ask once for all hooks, not per-hook.
 
   2. Pick the event and matcher from the preference:
      - "after every edit" → \`PostToolUse\` with matcher \`Write|Edit\`
@@ -214,13 +214,13 @@ Act on each "yes" before moving on.
 
 Recap what was set up — which files were written and the key points included in each. Remind the user these files are a starting point: they should review and tweak them, and can run \`/init\` again anytime to re-scan.
 
-Then tell the user that you'll be introducing a few more suggestions for optimizing their codebase and Claude Code setup based on what you found. Present these as a single, well-formatted to-do list where every item is relevant to this repo. Put the most impactful items first.
+Then tell the user that you'll be introducing a few more suggestions for optimizing their codebase and Xela setup based on what you found. Present these as a single, well-formatted to-do list where every item is relevant to this repo. Put the most impactful items first.
 
 When building the list, work through these checks and include only what applies:
 - If frontend code was detected (React, Vue, Svelte, etc.): \`/plugin install frontend-design@claude-plugins-official\` gives Claude design principles and component patterns so it produces polished UI; \`/plugin install playwright@claude-plugins-official\` lets Claude launch a real browser, screenshot what it built, and fix visual bugs itself.
 - If you found gaps in Phase 7 (missing GitHub CLI, missing linting) and the user said no: list them here with a one-line reason why each helps.
 - If tests are missing or sparse: suggest setting up a test framework so Claude can verify its own changes.
-- To help you create skills and optimize existing skills using evals, Claude Code has an official skill-creator plugin you can install. Install it with \`/plugin install skill-creator@claude-plugins-official\`, then run \`/skill-creator <skill-name>\` to create new skills or refine any existing skill. (Always include this one.)
+- To help you create skills and optimize existing skills using evals, Xela has an official skill-creator plugin you can install. Install it with \`/plugin install skill-creator@claude-plugins-official\`, then run \`/skill-creator <skill-name>\` to create new skills or refine any existing skill. (Always include this one.)
 - Browse official plugins with \`/plugin\` — these bundle skills, agents, hooks, and MCP servers that you may find helpful. You can also create your own custom plugins to share them with others. (Always include this one.)`
 
 const command = {
@@ -230,8 +230,8 @@ const command = {
     return feature('NEW_INIT') &&
       (process.env.USER_TYPE === 'ant' ||
         isEnvTruthy(process.env.CLAUDE_CODE_NEW_INIT))
-      ? 'Initialize new CLAUDE.md file(s) and optional skills/hooks with codebase documentation'
-      : 'Initialize a new CLAUDE.md file with codebase documentation'
+      ? 'Initialize new XELA.md file(s) and optional skills/hooks with codebase documentation'
+      : 'Initialize a new XELA.md file with codebase documentation'
   },
   contentLength: 0, // Dynamic content
   progressMessage: 'analyzing your codebase',

package/src/components/Settings/Config.tsx

@@ -975,7 +975,7 @@ export function Config({
     }
   }] : []), ...(shouldShowExternalIncludesToggle ? [{
     id: 'showExternalIncludesDialog',
-    label: 'External CLAUDE.md includes',
+    label: 'External XELA.md includes',
     value: (() => {
       const projectConfig = getCurrentProjectConfig();
       if (projectConfig.hasClaudeMdExternalIncludesApproved) {

package/src/components/memory/MemoryFileSelector.tsx

@@ -48,8 +48,8 @@ export function MemoryFileSelector(t0) {
     onCancel
   } = t0;
   const existingMemoryFiles = use(getMemoryFiles());
-  const userMemoryPath = join(getClaudeConfigHomeDir(), "CLAUDE.md");
-  const projectMemoryPath = join(getOriginalCwd(), "CLAUDE.md");
+  const userMemoryPath = join(getClaudeConfigHomeDir(), "XELA.md");
+  const projectMemoryPath = join(getOriginalCwd(), "XELA.md");
   const hasUserMemory = existingMemoryFiles.some(f => f.path === userMemoryPath);
   const hasProjectMemory = existingMemoryFiles.some(f_0 => f_0.path === projectMemoryPath);
   const allMemoryFiles = [...existingMemoryFiles.filter(_temp).map(_temp2), ...(hasUserMemory ? [] : [{

package/src/constants/prompts.ts

@@ -255,7 +255,7 @@ function getSimpleDoingTasksSection(): string {
 function getActionsSection(): string {
   return `# Executing actions with care
 
-Carefully consider the reversibility and blast radius of actions. Generally you can freely take local, reversible actions like editing files or running tests. But for actions that are hard to reverse, affect shared systems beyond your local environment, or could otherwise be risky or destructive, check with the user before proceeding. The cost of pausing to confirm is low, while the cost of an unwanted action (lost work, unintended messages sent, deleted branches) can be very high. For actions like these, consider the context, the action, and user instructions, and by default transparently communicate the action and ask for confirmation before proceeding. This default can be changed by user instructions - if explicitly asked to operate more autonomously, then you may proceed without confirmation, but still attend to the risks and consequences when taking actions. A user approving an action (like a git push) once does NOT mean that they approve it in all contexts, so unless actions are authorized in advance in durable instructions like CLAUDE.md files, always confirm first. Authorization stands for the scope specified, not beyond. Match the scope of your actions to what was actually requested.
+Carefully consider the reversibility and blast radius of actions. Generally you can freely take local, reversible actions like editing files or running tests. But for actions that are hard to reverse, affect shared systems beyond your local environment, or could otherwise be risky or destructive, check with the user before proceeding. The cost of pausing to confirm is low, while the cost of an unwanted action (lost work, unintended messages sent, deleted branches) can be very high. For actions like these, consider the context, the action, and user instructions, and by default transparently communicate the action and ask for confirmation before proceeding. This default can be changed by user instructions - if explicitly asked to operate more autonomously, then you may proceed without confirmation, but still attend to the risks and consequences when taking actions. A user approving an action (like a git push) once does NOT mean that they approve it in all contexts, so unless actions are authorized in advance in durable instructions like XELA.md files, always confirm first. Authorization stands for the scope specified, not beyond. Match the scope of your actions to what was actually requested.
 
 Examples of the kind of risky actions that warrant user confirmation:
 - Destructive operations: deleting files/branches, dropping database tables, killing processes, rm -rf, overwriting uncommitted changes

package/src/projectOnboardingState.ts

@@ -18,6 +18,8 @@ export type Step = {
 
 export function getSteps(): Step[] {
   const hasClaudeMd = getFsImplementation().existsSync(
+    join(getCwd(), 'XELA.md'),
+  ) || getFsImplementation().existsSync(
     join(getCwd(), 'CLAUDE.md'),
   )
   const isWorkspaceDirEmpty = isDirEmpty(getCwd())
@@ -32,7 +34,7 @@ export function getSteps(): Step[] {
     },
     {
       key: 'claudemd',
-      text: 'Run /init to create a CLAUDE.md file with instructions for Claude',
+      text: 'Run /init to create a XELA.md file with project instructions',
       isComplete: hasClaudeMd,
       isCompletable: true,
       isEnabled: !isWorkspaceDirEmpty,

package/src/services/SessionMemory/prompts.ts

@@ -43,7 +43,7 @@ _Step by step, what was attempted, done? Very terse summary for each step_
 function getDefaultUpdatePrompt(): string {
   return `IMPORTANT: This message and these instructions are NOT part of the actual user conversation. Do NOT include any references to "note-taking", "session notes extraction", or these update instructions in the notes content.
 
-Based on the user conversation above (EXCLUDING this note-taking instruction message as well as system prompt, claude.md entries, or any past session summaries), update the session notes file.
+Based on the user conversation above (EXCLUDING this note-taking instruction message as well as system prompt, xela.md entries, or any past session summaries), update the session notes file.
 
 The file {{notesPath}} has already been read for you. Here are its current contents:
 <current_notes_content>
@@ -63,7 +63,7 @@ CRITICAL RULES FOR EDITING:
 - It's OK to skip updating a section if there are no substantial new insights to add. Do not add filler content like "No info yet", just leave sections blank/unedited if appropriate.
 - Write DETAILED, INFO-DENSE content for each section - include specifics like file paths, function names, error messages, exact commands, technical details, etc.
 - For "Key results", include the complete, exact output the user requested (e.g., full table, full answer, etc.)
-- Do not include information that's already in the CLAUDE.md files included in the context
+- Do not include information that's already in the XELA.md files included in the context
 - Keep each section under ~${MAX_SECTION_LENGTH} tokens/words - if a section is approaching this limit, condense it by cycling out less important details while preserving the most critical information
 - Focus on actionable, specific information that would help someone understand or recreate the work discussed in the conversation
 - IMPORTANT: Always update "Current State" to reflect the most recent work - this is critical for continuity after compaction

package/src/services/settingsSync/types.ts

@@ -60,7 +60,7 @@ export type SettingsSyncUploadResult = {
  */
 export const SYNC_KEYS = {
   USER_SETTINGS: '~/.claude/settings.json',
-  USER_MEMORY: '~/.claude/CLAUDE.md',
+  USER_MEMORY: '~/.claude/XELA.md',
   projectSettings: (projectId: string) =>
     `projects/${projectId}/.claude/settings.local.json`,
   projectMemory: (projectId: string) => `projects/${projectId}/CLAUDE.local.md`,

package/src/skills/bundled/remember.ts

@@ -14,7 +14,7 @@ Review the user's memory landscape and produce a clear report of proposed change
 ## Steps
 
 ### 1. Gather all memory layers
-Read CLAUDE.md and CLAUDE.local.md from the project root (if they exist). Your auto-memory content is already in your system prompt — review it there. Note which team memory sections exist, if any.
+Read XELA.md and XELA.local.md from the project root (if they exist). Your auto-memory content is already in your system prompt — review it there. Note which team memory sections exist, if any.
 
 **Success criteria**: You have the contents of all memory layers and can compare them.
 
@@ -23,13 +23,13 @@ For each substantive entry in auto-memory, determine the best destination:
 
 | Destination | What belongs there | Examples |
 |---|---|---|
-| **CLAUDE.md** | Project conventions and instructions for Claude that all contributors should follow | "use bun not npm", "API routes use kebab-case", "test command is bun test", "prefer functional style" |
-| **CLAUDE.local.md** | Personal instructions for Claude specific to this user, not applicable to other contributors | "I prefer concise responses", "always explain trade-offs", "don't auto-commit", "run tests before committing" |
+| **XELA.md** | Project conventions and instructions for Claude that all contributors should follow | "use bun not npm", "API routes use kebab-case", "test command is bun test", "prefer functional style" |
+| **XELA.local.md** | Personal instructions for Claude specific to this user, not applicable to other contributors | "I prefer concise responses", "always explain trade-offs", "don't auto-commit", "run tests before committing" |
 | **Team memory** | Org-wide knowledge that applies across repositories (only if team memory is configured) | "deploy PRs go through #deploy-queue", "staging is at staging.internal", "platform team owns infra" |
 | **Stay in auto-memory** | Working notes, temporary context, or entries that don't clearly fit elsewhere | Session-specific observations, uncertain patterns |
 
 **Important distinctions:**
-- CLAUDE.md and CLAUDE.local.md contain instructions for Claude, not user preferences for external tools (editor theme, IDE keybindings, etc. don't belong in either)
+- XELA.md and XELA.local.md contain instructions for Claude, not user preferences for external tools (editor theme, IDE keybindings, etc. don't belong in either)
 - Workflow practices (PR conventions, merge strategies, branch naming) are ambiguous — ask the user whether they're personal or team-wide
 - When unsure, ask rather than guess
 
@@ -37,8 +37,8 @@ For each substantive entry in auto-memory, determine the best destination:
 
 ### 3. Identify cleanup opportunities
 Scan across all layers for:
-- **Duplicates**: Auto-memory entries already captured in CLAUDE.md or CLAUDE.local.md → propose removing from auto-memory
-- **Outdated**: CLAUDE.md or CLAUDE.local.md entries contradicted by newer auto-memory entries → propose updating the older layer
+- **Duplicates**: Auto-memory entries already captured in XELA.md or XELA.local.md → propose removing from auto-memory
+- **Outdated**: XELA.md or XELA.local.md entries contradicted by newer auto-memory entries → propose updating the older layer
 - **Conflicts**: Contradictions between any two layers → propose resolution, noting which is more recent
 
 **Success criteria**: All cross-layer issues identified.
@@ -50,7 +50,7 @@ Output a structured report grouped by action type:
 3. **Ambiguous** — entries where you need the user's input on destination
 4. **No action needed** — brief note on entries that should stay put
 
-If auto-memory is empty, say so and offer to review CLAUDE.md for cleanup.
+If auto-memory is empty, say so and offer to review XELA.md for cleanup.
 
 **Success criteria**: User can review and approve/reject each proposal individually.
 
@@ -64,9 +64,9 @@ If auto-memory is empty, say so and offer to review CLAUDE.md for cleanup.
   registerBundledSkill({
     name: 'remember',
     description:
-      'Review auto-memory entries and propose promotions to CLAUDE.md, CLAUDE.local.md, or shared memory. Also detects outdated, conflicting, and duplicate entries across memory layers.',
+      'Review auto-memory entries and propose promotions to XELA.md, XELA.local.md, or shared memory. Also detects outdated, conflicting, and duplicate entries across memory layers.',
     whenToUse:
-      'Use when the user wants to review, organize, or promote their auto-memory entries. Also useful for cleaning up outdated or conflicting entries across CLAUDE.md, CLAUDE.local.md, and auto-memory.',
+      'Use when the user wants to review, organize, or promote their auto-memory entries. Also useful for cleaning up outdated or conflicting entries across XELA.md, XELA.local.md, and auto-memory.',
     userInvocable: true,
     isEnabled: () => isAutoMemoryEnabled(),
     async getPromptForCommand(args) {

package/src/tools/FileEditTool/FileEditTool.ts

@@ -525,7 +525,7 @@ export const FileEditTool = buildTool({
     })
 
     // 7. Log events
-    if (absoluteFilePath.endsWith(`${sep}CLAUDE.md`)) {
+    if (absoluteFilePath.endsWith(`${sep}XELA.md`) || absoluteFilePath.endsWith(`${sep}CLAUDE.md`)) {
       logEvent('tengu_write_claudemd', {})
     }
     countLinesChanged(patch)

package/src/tools/FileWriteTool/FileWriteTool.ts

@@ -336,8 +336,8 @@ export const FileWriteTool = buildTool({
       limit: undefined,
     })
 
-    // Log when writing to CLAUDE.md
-    if (fullFilePath.endsWith(`${sep}CLAUDE.md`)) {
+    // Log when writing to XELA.md or CLAUDE.md
+    if (fullFilePath.endsWith(`${sep}XELA.md`) || fullFilePath.endsWith(`${sep}CLAUDE.md`)) {
       logEvent('tengu_write_claudemd', {})
     }
 

package/src/utils/claudemd.ts

@@ -883,20 +883,39 @@ export const getMemoryFiles = memoize(
         pathInWorkingPath(dir, canonicalRoot) &&
         !pathInWorkingPath(dir, gitRoot)
 
-      // Try reading CLAUDE.md (Project) - only if projectSettings is enabled
+      // Try reading XELA.md or CLAUDE.md (Project) - only if projectSettings is enabled
       if (isSettingSourceEnabled('projectSettings') && !skipProject) {
-        const projectPath = join(dir, 'CLAUDE.md')
+        // Prefer XELA.md, fall back to CLAUDE.md for backwards compatibility
+        const xelaPath = join(dir, 'XELA.md')
+        const claudePath = join(dir, 'CLAUDE.md')
         result.push(
           ...(await processMemoryFile(
-            projectPath,
+            xelaPath,
+            'Project',
+            processedPaths,
+            includeExternal,
+          )),
+        )
+        result.push(
+          ...(await processMemoryFile(
+            claudePath,
             'Project',
             processedPaths,
             includeExternal,
           )),
         )
 
-        // Try reading .claude/CLAUDE.md (Project)
+        // Try reading .claude/XELA.md or .claude/CLAUDE.md (Project)
+        const dotXelaPath = join(dir, '.claude', 'XELA.md')
         const dotClaudePath = join(dir, '.claude', 'CLAUDE.md')
+        result.push(
+          ...(await processMemoryFile(
+            dotXelaPath,
+            'Project',
+            processedPaths,
+            includeExternal,
+          )),
+        )
         result.push(
           ...(await processMemoryFile(
             dotClaudePath,
@@ -919,8 +938,17 @@ export const getMemoryFiles = memoize(
         )
       }
 
-      // Try reading CLAUDE.local.md (Local) - only if localSettings is enabled
+      // Try reading XELA.local.md or CLAUDE.local.md (Local) - only if localSettings is enabled
       if (isSettingSourceEnabled('localSettings')) {
+        const xelaLocalPath = join(dir, 'XELA.local.md')
+        result.push(
+          ...(await processMemoryFile(
+            xelaLocalPath,
+            'Local',
+            processedPaths,
+            includeExternal,
+          )),
+        )
         const localPath = join(dir, 'CLAUDE.local.md')
         result.push(
           ...(await processMemoryFile(
@@ -940,7 +968,16 @@ export const getMemoryFiles = memoize(
     if (isEnvTruthy(process.env.CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD)) {
       const additionalDirs = getAdditionalDirectoriesForClaudeMd()
       for (const dir of additionalDirs) {
-        // Try reading CLAUDE.md from the additional directory
+        // Try reading XELA.md or CLAUDE.md from the additional directory
+        const xelaPath_add = join(dir, 'XELA.md')
+        result.push(
+          ...(await processMemoryFile(
+            xelaPath_add,
+            'Project',
+            processedPaths,
+            includeExternal,
+          )),
+        )
         const projectPath = join(dir, 'CLAUDE.md')
         result.push(
           ...(await processMemoryFile(
@@ -951,7 +988,16 @@ export const getMemoryFiles = memoize(
           )),
         )
 
-        // Try reading .claude/CLAUDE.md from the additional directory
+        // Try reading .claude/XELA.md or .claude/CLAUDE.md from the additional directory
+        const dotXelaPath_add = join(dir, '.claude', 'XELA.md')
+        result.push(
+          ...(await processMemoryFile(
+            dotXelaPath_add,
+            'Project',
+            processedPaths,
+            includeExternal,
+          )),
+        )
         const dotClaudePath = join(dir, '.claude', 'CLAUDE.md')
         result.push(
           ...(await processMemoryFile(
@@ -1253,30 +1299,34 @@ export async function getMemoryFilesForNestedDirectory(
 ): Promise<MemoryFileInfo[]> {
   const result: MemoryFileInfo[] = []
 
-  // Process project memory files (CLAUDE.md and .claude/CLAUDE.md)
+  // Process project memory files (XELA.md/CLAUDE.md and .claude/XELA.md/.claude/CLAUDE.md)
   if (isSettingSourceEnabled('projectSettings')) {
-    const projectPath = join(dir, 'CLAUDE.md')
-    result.push(
-      ...(await processMemoryFile(
-        projectPath,
-        'Project',
-        processedPaths,
-        false,
-      )),
-    )
-    const dotClaudePath = join(dir, '.claude', 'CLAUDE.md')
-    result.push(
-      ...(await processMemoryFile(
-        dotClaudePath,
-        'Project',
-        processedPaths,
-        false,
-      )),
-    )
+    for (const fname of ['XELA.md', 'CLAUDE.md']) {
+      result.push(
+        ...(await processMemoryFile(
+          join(dir, fname),
+          'Project',
+          processedPaths,
+          false,
+        )),
+      )
+      result.push(
+        ...(await processMemoryFile(
+          join(dir, '.claude', fname),
+          'Project',
+          processedPaths,
+          false,
+        )),
+      )
+    }
   }
 
-  // Process local memory file (CLAUDE.local.md)
+  // Process local memory file (XELA.local.md/CLAUDE.local.md)
   if (isSettingSourceEnabled('localSettings')) {
+    const xelaLocalPath = join(dir, 'XELA.local.md')
+    result.push(
+      ...(await processMemoryFile(xelaLocalPath, 'Local', processedPaths, false)),
+    )
     const localPath = join(dir, 'CLAUDE.local.md')
     result.push(
       ...(await processMemoryFile(localPath, 'Local', processedPaths, false)),
@@ -1435,8 +1485,8 @@ export async function shouldShowClaudeMdExternalIncludesWarning(): Promise<boole
 export function isMemoryFilePath(filePath: string): boolean {
   const name = basename(filePath)
 
-  // CLAUDE.md or CLAUDE.local.md anywhere
-  if (name === 'CLAUDE.md' || name === 'CLAUDE.local.md') {
+  // XELA.md, CLAUDE.md, XELA.local.md, or CLAUDE.local.md anywhere
+  if (name === 'XELA.md' || name === 'CLAUDE.md' || name === 'XELA.local.md' || name === 'CLAUDE.local.md') {
     return true
   }
 

package/src/utils/config.ts

@@ -1781,13 +1781,13 @@ export function getMemoryPath(memoryType: MemoryType): string {
 
   switch (memoryType) {
     case 'User':
-      return join(getClaudeConfigHomeDir(), 'CLAUDE.md')
+      return join(getClaudeConfigHomeDir(), 'XELA.md')
     case 'Local':
-      return join(cwd, 'CLAUDE.local.md')
+      return join(cwd, 'XELA.local.md')
     case 'Project':
-      return join(cwd, 'CLAUDE.md')
+      return join(cwd, 'XELA.md')
     case 'Managed':
-      return join(getManagedFilePath(), 'CLAUDE.md')
+      return join(getManagedFilePath(), 'XELA.md')
     case 'AutoMem':
       return getAutoMemEntrypoint()
   }

package/src/_shims/_generated_stubs/_universal_stub.mjs

@@ -1,168 +0,0 @@
-// Universal stub — exports all known names for unresolved modules
-export default {};
-
-// --- Arrays (names ending in S, LIST, TOOLS, etc.) ---
-export const BROWSER_TOOLS = [];
-export const DEFAULT_SESSION_TIMEOUT_MS = [];
-export const RARITY_COLORS = [];
-export const EYES = [];
-export const HATS = [];
-export const RARITIES = [];
-export const RARITY_WEIGHTS = [];
-export const SPECIES = [];
-export const STAT_NAMES = [];
-export const AGENT_PATHS = [];
-export const DEFAULT_GRANT_FLAGS = [];
-export const MEMORY_TYPE_VALUES = [];
-export const SYNC_KEYS = [];
-export const CUSTOMIZATION_SURFACES = [];
-export const FIND_KEYS = [];
-export const OPERATORS = [];
-export const SIMPLE_MOTIONS = [];
-export const TEXT_OBJ_SCOPES = [];
-export const TEXT_OBJ_TYPES = [];
-export const SOURCES = [];
-export const FRAME_INTERVAL_MS = [];
-export const ONE_SHOT_BUILTIN_AGENT_TYPES = [];
-export const REPL_ONLY_TOOLS = [];
-export const SETTING_SOURCES = [];
-export const MDM_SUBPROCESS_TIMEOUT_MS = [];
-
-// --- Functions (is/has/get/set/create/handle...) ---
-export const isBackgroundTask = () => undefined;
-export const isInProcessTeammateTask = () => undefined;
-export const isMcpServerCommandEntry = () => undefined;
-export const isMcpServerNameEntry = () => undefined;
-export const isMcpServerUrlEntry = () => undefined;
-export const isPaneBackend = () => undefined;
-export const isOperatorKey = () => undefined;
-export const isTextObjScopeKey = () => undefined;
-export const isReplModeEnabled = () => undefined;
-export const isSettingSourceEnabled = () => undefined;
-export const getSourceDisplayName = () => undefined;
-export const getSettingSourceName = () => undefined;
-export const getSwarmSocketName = () => undefined;
-export const getSettingSourceDisplayNameLowercase = () => undefined;
-export const getSettingSourceDisplayNameCapitalized = () => undefined;
-export const getEnabledSettingSources = () => undefined;
-export const getMacOSPlistPaths = () => undefined;
-export const getSyntaxTheme = () => undefined;
-export const createClaudeForChromeMcpServer = () => undefined;
-export const createInitialPersistentState = () => undefined;
-export const createInitialVimState = () => undefined;
-export const parseSettingSourcesFlag = () => undefined;
-export const reduceAnsiCodes = () => undefined;
-
-// --- Constants/schemas/values ---
-export const BRIDGE_LOGIN_INSTRUCTION = undefined;
-export const BRIDGE_LOGIN_ERROR = undefined;
-export const axolotl = undefined;
-export const blob = undefined;
-export const cactus = undefined;
-export const capybara = undefined;
-export const cat = undefined;
-export const chonk = undefined;
-export const dragon = undefined;
-export const duck = undefined;
-export const ghost = undefined;
-export const goose = undefined;
-export const mushroom = undefined;
-export const octopus = undefined;
-export const owl = undefined;
-export const penguin = undefined;
-export const rabbit = undefined;
-export const robot = undefined;
-export const snail = undefined;
-export const turtle = undefined;
-export const ElicitRequestSchema = undefined;
-export const ElicitationCompleteNotificationSchema = undefined;
-export const REMOTE_CONTROL_DISCONNECTED_MSG = undefined;
-export const CallToolRequestSchema = undefined;
-export const ListToolsRequestSchema = undefined;
-export const defaultStyle = undefined;
-export const connectResponseSchema = undefined;
-export const CallToolResultSchema = undefined;
-export const ErrorCode = undefined;
-export const ListPromptsResultSchema = undefined;
-export const ListResourcesResultSchema = undefined;
-export const ListRootsRequestSchema = undefined;
-export const ListToolsResultSchema = undefined;
-export const McpError = undefined;
-export const McpJsonConfigSchema = undefined;
-export const McpServerConfigSchema = undefined;
-export const PromptListChangedNotificationSchema = undefined;
-export const ResourceListChangedNotificationSchema = undefined;
-export const ToolListChangedNotificationSchema = undefined;
-export const ConfigScopeSchema = undefined;
-export const PolicyLimitsResponseSchema = undefined;
-export const SettingsSchema = undefined;
-export const RemoteManagedSettingsResponseSchema = undefined;
-export const UserSyncDataSchema = undefined;
-export const TeamMemoryDataSchema = undefined;
-export const TeamMemoryTooManyEntriesSchema = undefined;
-export const HooksSchema = undefined;
-export const appendCappedMessage = undefined;
-export const inputSchema = undefined;
-export const outputSchema = undefined;
-export const gitDiffSchema = undefined;
-export const hunkSchema = undefined;
-export const ReadResourceResultSchema = undefined;
-export const TodoListSchema = undefined;
-export const McpStdioServerConfigSchema = undefined;
-export const DEFAULT_UPLOAD_CONCURRENCY = undefined;
-export const FILE_COUNT_LIMIT = undefined;
-export const OUTPUTS_SUBDIR = undefined;
-export const JSONRPCMessageSchema = undefined;
-export const MAX_VIM_COUNT = undefined;
-export const AGENT_TOOL_NAME = undefined;
-export const LEGACY_AGENT_TOOL_NAME = undefined;
-export const EXIT_PLAN_MODE_V2_TOOL_NAME = undefined;
-export const TEAM_CREATE_TOOL_NAME = undefined;
-export const CLAUDE_FOLDER_PERMISSION_PATTERN = undefined;
-export const FILE_EDIT_TOOL_NAME = undefined;
-export const GLOBAL_CLAUDE_FOLDER_PERMISSION_PATTERN = undefined;
-export const SKILL_TOOL_NAME = undefined;
-export const TEAM_LEAD_NAME = undefined;
-export const TMUX_COMMAND = undefined;
-export const VERIFICATION_AGENT_TYPE = undefined;
-export const TODO_WRITE_TOOL_NAME = undefined;
-export const TASK_CREATE_TOOL_NAME = undefined;
-export const TASK_OUTPUT_TOOL_NAME = undefined;
-export const ENTER_PLAN_MODE_TOOL_NAME = undefined;
-export const NOTEBOOK_EDIT_TOOL_NAME = undefined;
-export const SEND_MESSAGE_TOOL_NAME = undefined;
-export const TASK_GET_TOOL_NAME = undefined;
-export const TASK_LIST_TOOL_NAME = undefined;
-export const TASK_UPDATE_TOOL_NAME = undefined;
-export const ENTER_WORKTREE_TOOL_NAME = undefined;
-export const EXIT_WORKTREE_TOOL_NAME = undefined;
-export const WORKFLOW_TOOL_NAME = undefined;
-export const TEAM_DELETE_TOOL_NAME = undefined;
-export const ContinuousEventPriority = undefined;
-export const DefaultEventPriority = undefined;
-export const DiscreteEventPriority = undefined;
-export const NoEventPriority = undefined;
-export const ConcurrentRoot = undefined;
-export const LegacyRoot = undefined;
-export const REPL_TOOL_NAME = undefined;
-export const EXIT_PLAN_MODE_TOOL_NAME = undefined;
-export const CONFIG_TOOL_NAME = undefined;
-export const FILE_UNEXPECTEDLY_MODIFIED_ERROR = undefined;
-export const TOOL_SEARCH_TOOL_NAME = undefined;
-export const SWARM_SESSION_NAME = undefined;
-export const TEAMMATE_COMMAND_ENV_VAR = undefined;
-export const PLUTIL_ARGS_PREFIX = undefined;
-export const PLUTIL_PATH = undefined;
-export const WINDOWS_REGISTRY_KEY_PATH_HKCU = undefined;
-export const WINDOWS_REGISTRY_KEY_PATH_HKLM = undefined;
-export const WINDOWS_REGISTRY_VALUE_NAME = undefined;
-export const CLAUDE_CODE_SETTINGS_SCHEMA_URL = undefined;
-export const HIDDEN_SESSION_NAME = undefined;
-export const SWARM_VIEW_WINDOW_NAME = undefined;
-export const ColorDiff = undefined;
-export const ColorFile = undefined;
-export const ansiCodesToString = undefined;
-export const diffAnsiCodes = undefined;
-export const styledCharsFromTokens = undefined;
-export const tokenize = undefined;
-export const undoAnsiCodes = undefined;

package/src/_shims/_generated_stubs/text_stub.mjs

@@ -1 +0,0 @@
-export default '';