chore: rename all CodeIndex references to Codei

pnftrading · pnftrading · commit f99e2e6e7866 · 2026-06-27T10:21:24.000+07:00
This commit fully rebrands the project from CodeIndex to Codei by updating: - Package author fields across all package.json files - Code comments, test temporary directories, and configuration values - Documentation, user guides, and AI integration skill files - npm package scope references from @CodeIndex to @codei
diff --git a/.trae/rules/project_rules.md b/.trae/rules/project_rules.md
@@ -1,12 +1,12 @@
-# Project Rules: codeindex
+# Project Rules: codei
 
 ## Agent Skill Integration
 
-This project defines a universal `codeindex` skill at `.trae/skills/codeindex/SKILL.md`.
+This project defines a universal `codei` skill at `.trae/skills/codei/SKILL.md`.
 
 ## Mandatory Workflow
 
-**Before performing ANY of these tasks, the agent MUST load and use the codeindex skill:**
+**Before performing ANY of these tasks, the agent MUST load and use the codei skill:**
 
 1. **Understanding codebase structure** — Any question about how code is organized
 2. **Following dependencies** — Tracing imports, understanding coupling
@@ -18,7 +18,7 @@ This project defines a universal `codeindex` skill at `.trae/skills/codeindex/SK
 ## Skill Loading
 
 ```
-When working with codeindex codebase, invoke the "codeindex" skill.
+When working with codei codebase, invoke the "codei" skill.
 ```
 
 ## Quick Reference
diff --git a/.trae/skills/codei/SKILL.md b/.trae/skills/codei/SKILL.md
@@ -1,17 +1,17 @@
 ---
-name: "codeindex"
+name: "codei"
 description: "Retrieves relevant code context from a hierarchical index to reduce token usage and improve AI coding accuracy. Invoke when understanding codebase structure, following dependencies, or needing targeted code context for a task."
 ---
 
-# Codeindex — Vectorless Reasoning-Based Code Index
+# Codei — Vectorless Reasoning-Based Code Index
 
 ## Overview
 
-`codeindex` builds a hierarchical tree index of your codebase and uses LLM reasoning to retrieve only the relevant context you need — reducing token usage from **50,000+ tokens to ~1,000-3,000 tokens** per query.
+`codei` builds a hierarchical tree index of your codebase and uses LLM reasoning to retrieve only the relevant context you need — reducing token usage from **50,000+ tokens to ~1,000-3,000 tokens** per query.
 
 ## When to Invoke This Skill
 
-**Invoke codeindex when:**
+**Invoke codei when:**
 - User asks about how a feature/component works
 - Need to understand code structure or dependencies
 - Following import/dependency chains
@@ -28,66 +28,66 @@ description: "Retrieves relevant code context from a hierarchical index to reduc
 ## Prerequisites
 
 Before using this skill, ensure:
-1. `codeindex` is installed: `npm install -g @codeindex/codeindex` or run from source
-2. Project has been indexed: `codeindex index <project-path>`
-3. LLM API key is configured: `codeindex setup`
+1. `codei` is installed: `npm install -g @codei/cli` or run from source
+2. Project has been indexed: `codei index <project-path>`
+3. LLM API key is configured: `codei setup`
 
 ## Core Workflow
 
 ### 1. Check Index Status
 
 ```bash
-codeindex status <project-path>
+codei status <project-path>
 ```
 
 If index is stale or missing, rebuild:
 ```bash
-codeindex index <project-path>
+codei index <project-path>
 ```
 
 ### 2. Query for Context
 
 ```bash
-codeindex query "<your question>" --cwd <project-path>
+codei query "<your question>" --cwd <project-path>
 ```
 
 **Examples:**
 ```bash
 # Understand authentication flow
-codeindex query "How does JWT authentication work in this codebase?"
+codei query "How does JWT authentication work in this codebase?"
 
 # Find relevant service for a feature
-codeindex query "Where is user profile management implemented?"
+codei query "Where is user profile management implemented?"
 
 # Understand dependencies
-codeindex query "What does the order processing module depend on?"
+codei query "What does the order processing module depend on?"
 
 # Debug tracing
-codeindex query "Trace the request flow for API calls"
+codei query "Trace the request flow for API calls"
 ```
 
 ### 3. Get Detailed Context with Options
 
 ```bash
 # Include dependency signatures in output
-codeindex query "<question>" --cwd <path> --format text
+codei query "<question>" --cwd <path> --format text
 
 # JSON output for programmatic use
-codeindex query "<question>" --cwd <path> --format json
+codei query "<question>" --cwd <path> --format json
 
 # Verbose mode shows traversal path
-codeindex query "<question>" --cwd <path> --verbose
+codei query "<question>" --cwd <path> --verbose
 
 # Control output size
-codeindex query "<question>" --cwd <path> --max-tokens 2000
-codeindex query "<question>" --cwd <path> --max-symbols 5
+codei query "<question>" --cwd <path> --max-tokens 2000
+codei query "<question>" --cwd <path> --max-symbols 5
 ```
 
 ## HTTP Server Mode (Recommended for Frequent Use)
 
 Start the server once per project:
 ```bash
-codeindex serve <project-path> --port 3131
+codei serve <project-path> --port 3131
 ```
 
 Then query via HTTP:
@@ -139,7 +139,7 @@ class UserService { ... }
 ## Integration with AI Agents
 
 ### Claude Code
-Add to `~/.claude/tools/codeindex.sh`:
+Add to `~/.claude/tools/codei.sh`:
 ```bash
 #!/bin/bash
 QUERY="$1"
@@ -152,7 +152,7 @@ curl -s -X POST http://localhost:3131/query \
 ### Cursor/Windsurf
 Create `.cursorrules` or `.windsurfrules`:
 ```markdown
-# Codeindex Context Retrieval
+# Codei Context Retrieval
 When you need to understand the codebase:
 1. Run: curl -s -X POST http://localhost:3131/query -d '{"query": "YOUR_QUERY"}' | jq -r '.context'
 2. Use the output for context before implementing
@@ -161,8 +161,8 @@ When you need to understand the codebase:
 ### Cline (VSCode)
 In custom instructions or Plan Mode:
 ```
-Use codeindex query "<your question>" to get relevant code context.
-Start server with: codeindex serve . --port 3131
+Use codei query "<your question>" to get relevant code context.
+Start server with: codei serve . --port 3131
 ```
 
 ## Architecture Notes
@@ -190,8 +190,8 @@ Project
 
 | Issue | Solution |
 |-------|----------|
-| "No index found" | Run `codeindex index <path>` first |
-| "API key not found" | Run `codeindex setup` or set `OPENAI_API_KEY` env var |
-| Stale results | Run `codeindex update <path>` after file changes |
+| "No index found" | Run `codei index <path>` first |
+| "API key not found" | Run `codei setup` or set `OPENAI_API_KEY` env var |
+| Stale results | Run `codei update <path>` after file changes |
 | High token usage | Reduce `--max-tokens` or `--max-symbols` |
-| Slow queries | Use local LLM (Ollama) via `codeindex setup` with `--provider ollama` |
+| Slow queries | Use local LLM (Ollama) via `codei setup` with `--provider ollama` |
diff --git a/AGENTS.md b/AGENTS.md
@@ -46,7 +46,7 @@ Start server with: codei serve . --port 3131
 ```
 
 ### Trae Agent
-Load the `codeindex` skill from `.trae/skills/codeindex/SKILL.md` for full integration.
+Load the `codei` skill from `.trae/skills/codei/SKILL.md` for full integration.
 
 ## ❌ DON'T vs ✅ DO
 
diff --git a/docs/RELEASING.md b/docs/RELEASING.md
@@ -65,7 +65,7 @@ pnpm run release:publish
 ## Notes
 
 - The GitHub workflow at `.github/workflows/release.yml` uses `changesets/action` to open or update a release PR automatically on `main`.
-- To enable npm publishing from GitHub Actions, add an `NPM_TOKEN` repository secret with publish access to the `@codeindex` scope and the `@codei` scope.
+- To enable npm publishing from GitHub Actions, add an `NPM_TOKEN` repository secret with publish access to the `@codei` scope.
 - `release:publish` runs `release:check` first.
 - Packages are published in topological dependency order so `@codei/core` is available before adapters and `@codei/cli`.
 - The website package is private and is not part of npm publishing.
diff --git a/packages/adapter-cpp/package.json b/packages/adapter-cpp/package.json
@@ -33,7 +33,7 @@
     "llm",
     "rag"
   ],
-  "author": "CodeIndex Team",
+  "author": "Codei Team",
   "license": "MIT",
   "publishConfig": {
     "access": "public"
diff --git a/packages/adapter-csharp/package.json b/packages/adapter-csharp/package.json
@@ -33,7 +33,7 @@
     "llm",
     "rag"
   ],
-  "author": "CodeIndex Team",
+  "author": "Codei Team",
   "license": "MIT",
   "publishConfig": {
     "access": "public"
diff --git a/packages/adapter-go/package.json b/packages/adapter-go/package.json
@@ -33,7 +33,7 @@
     "llm",
     "rag"
   ],
-  "author": "CodeIndex Team",
+  "author": "Codei Team",
   "license": "MIT",
   "publishConfig": {
     "access": "public"
diff --git a/packages/adapter-java/package.json b/packages/adapter-java/package.json
@@ -33,7 +33,7 @@
     "llm",
     "rag"
   ],
-  "author": "CodeIndex Team",
+  "author": "Codei Team",
   "license": "MIT",
   "publishConfig": {
     "access": "public"
diff --git a/packages/adapter-php/package.json b/packages/adapter-php/package.json
@@ -33,7 +33,7 @@
     "llm",
     "rag"
   ],
-  "author": "CodeIndex Team",
+  "author": "Codei Team",
   "license": "MIT",
   "publishConfig": {
     "access": "public"
diff --git a/packages/adapter-python/package.json b/packages/adapter-python/package.json
@@ -33,7 +33,7 @@
     "llm",
     "rag"
   ],
-  "author": "CodeIndex Team",
+  "author": "Codei Team",
   "license": "MIT",
   "publishConfig": {
     "access": "public"
diff --git a/packages/adapter-rust/package.json b/packages/adapter-rust/package.json
@@ -33,7 +33,7 @@
     "llm",
     "rag"
   ],
-  "author": "CodeIndex Team",
+  "author": "Codei Team",
   "license": "MIT",
   "publishConfig": {
     "access": "public"
diff --git a/packages/adapter-swift/package.json b/packages/adapter-swift/package.json
@@ -33,7 +33,7 @@
     "llm",
     "rag"
   ],
-  "author": "CodeIndex Team",
+  "author": "Codei Team",
   "license": "MIT",
   "publishConfig": {
     "access": "public"
diff --git a/packages/adapter-typescript/package.json b/packages/adapter-typescript/package.json
@@ -37,7 +37,7 @@
     "llm",
     "rag"
   ],
-  "author": "CodeIndex Team",
+  "author": "Codei Team",
   "license": "MIT",
   "publishConfig": {
     "access": "public"
diff --git a/packages/cli/src/commands/query.ts b/packages/cli/src/commands/query.ts
@@ -8,6 +8,19 @@ import { loadConfig } from "../config.js"
 import { createLLMClient, createIndexManager, createNoopLLMClient } from "../createServices.js"
 import { FileSystemIndexStore, Retriever, TraversalCache } from "@codei/core"
 
+type VerboseCacheStatus = "exact" | "similar" | "miss"
+
+export async function retrieveWithVerboseCacheStatus(
+  retriever: Pick<Retriever, "retrieve">,
+  cache: Pick<TraversalCache, "peek">,
+  tree: Awaited<ReturnType<FileSystemIndexStore["loadTree"]>>,
+  query: { query: string; maxOutputTokens: number; expandDeps: boolean }
+): Promise<{ result: Awaited<ReturnType<Retriever["retrieve"]>>; cacheStatus: VerboseCacheStatus }> {
+  const cacheStatus = cache.peek(query.query)?.kind ?? "miss"
+  const result = await retriever.retrieve(tree!, query)
+  return { result, cacheStatus }
+}
+
 export function registerQueryCommand(program: Command): void {
   program
     .command("query <text>")
@@ -55,7 +68,7 @@ export function registerQueryCommand(program: Command): void {
           },
         })
 
-        const result = await retriever.retrieve(tree, {
+        const { result, cacheStatus } = await retrieveWithVerboseCacheStatus(retriever, cache, tree, {
           query: queryText,
           maxOutputTokens: parseInt(options["maxTokens"] as string ?? "4000"),
           expandDeps: options["deps"] !== false,
@@ -77,11 +90,10 @@ export function registerQueryCommand(program: Command): void {
         } else {
           // Text format — raw context sẵn sàng paste vào AI
           if (options["verbose"] === true) {
-            const peek = cache.peek(queryText)
             console.error(`[codei] Query: "${queryText}"`)
             console.error(`[codei] Traversal: ${result.traversalPath.join(" → ")}`)
             console.error(`[codei] Tokens: ~${result.estimatedTokens}`)
-            console.error(`[codei] Cache: ${peek ? peek.kind : "miss"}`)
+            console.error(`[codei] Cache: ${cacheStatus}`)
             console.error("---")
           }
 
diff --git a/packages/cli/tests/phase5.test.ts b/packages/cli/tests/phase5.test.ts
@@ -147,7 +147,7 @@ describe("loadConfig", () => {
     )
     await fs.writeFile(
       path.join(tmpDir, ".codei.json"),
-      JSON.stringify({ provider: "openai", model: "codeindex", indexDir: ".myindex-2" })
+      JSON.stringify({ provider: "openai", model: "codei", indexDir: ".myindex-2" })
     )
 
     const config = loadConfig(tmpDir)
diff --git a/packages/cli/tests/query-command.test.ts b/packages/cli/tests/query-command.test.ts
diff --git a/packages/core/package.json b/packages/core/package.json
diff --git a/packages/core/src/types/LLMClient.ts b/packages/core/src/types/LLMClient.ts
diff --git a/packages/core/tests/phase2.test.ts b/packages/core/tests/phase2.test.ts
