@travisennis/acai 0.0.1

package/.ai/plan.md

@@ -0,0 +1,131 @@
+Updated Plan: /mode Command with Project Config
+
+Schema Updates
+
+Extend the ProjectConfig schema to include mode as an enum with default 'build':
+
+// Add to config.ts
+const ModeSchema = z.enum(['build', 'explain', 'plan']);
+type Mode = z.infer<typeof ModeSchema>;
+
+const ProjectConfigSchema = z.object({
+  logs: z
+    .object({
+      path: z.string(),
+    })
+    .optional(),
+  tools: z
+    .object({
+      maxTokens: z.number().default(30000),
+    })
+    .optional()
+    .default({ maxTokens: 30000 }),
+  notify: z.boolean().optional().default(true),
+  mode: ModeSchema.default('build'), // Add this line
+});
+
+New Function in ConfigManager
+
+Add writeProjectConfig method to ConfigManager:
+
+async writeProjectConfig(config: Partial<ProjectConfig>): Promise<void> {
+  const projectConfigPath = path.join(this.project.getPath(), "acai.json");
+
+  // Read existing config
+  const existingConfig = await this.readProjectConfig();
+
+  // Merge with new config
+  const updatedConfig = {
+    ...existingConfig,
+    ...config,
+  };
+
+  // Validate and write
+  const validatedConfig = ProjectConfigSchema.parse(updatedConfig);
+  await fs.writeFile(
+    projectConfigPath,
+    JSON.stringify(validatedConfig, null, 2)
+  );
+}
+
+Updated Implementation Steps
+
+1. Update ProjectConfig Schema
+
+File: source/config.ts
+- Add ModeSchema enum
+- Add mode field to ProjectConfigSchema with default 'build'
+- Add writeProjectConfig method
+
+2. Update systemPrompt function
+
+File: source/prompts.ts
+- Add mode parameter to options
+- Load current mode from config
+- Append mode-specific content
+
+3. Create mode command
+
+File: source/commands/mode-command.ts
+- Use writeProjectConfig to save mode
+- Read current mode from readProjectConfig
+
+4. Update system prompt calls
+
+Files:
+- source/repl.ts
+- source/conversation-analyzer.ts
+
+Both need to:
+- Import config
+- Get current mode: const mode = (await config.readProjectConfig()).mode
+- Pass mode to systemPrompt
+
+5. Register mode command
+
+File: source/commands/manager.ts
+- Add modeCommand to commands array
+
+Updated Mode Command Implementation
+
+// source/commands/mode-command.ts
+import { select } from "@inquirer/prompts";
+import { config } from "../config.ts";
+
+export function modeCommand(options: CommandOptions): ReplCommand {
+  return {
+    command: '/mode',
+    description: 'Switch between different assistant modes',
+    result: 'continue',
+    getSubCommands: async () => ['build', 'explain', 'plan'],
+    execute: async (args: string[]) => {
+      const modes = ['build', 'explain', 'plan'] as const;
+      const currentConfig = await config.readProjectConfig();
+      const currentMode = currentConfig.mode;
+
+      if (args.length === 0) {
+        // Interactive mode selection
+        const selected = await select({
+          message: 'Select mode:',
+          choices: modes.map(m => ({ name: m, value: m })),
+          default: currentMode
+        });
+        if (selected) {
+          await config.writeProjectConfig({ mode: selected });
+          options.terminal.log(`✓ Switched to ${selected} mode`);
+        }
+      } else {
+        const mode = args[0] as typeof modes[number];
+        if (modes.includes(mode)) {
+          await config.writeProjectConfig({ mode });
+          options.terminal.log(`✓ Switched to ${mode} mode`);
+        } else {
+          options.terminal.error(`Invalid mode: ${mode}. Available: ${modes.join(', ')}`);
+        }
+      }
+    },
+  };
+}
+
+This approach uses the project-level config file (.acai/acai.json) to store the mode, making it
+project-specific rather than global.

package/.ai/prompt.md

@@ -0,0 +1 @@
+I want to update the prompt-command. Currently when using it you have to do `/prompt user:promp-name` or `/prompt project:prompt-name`. I want the behavior to just be `/prompt prompt-name`. There will still be prompts stored at the project and user levels, but they will be combined into a single list. If there is a conflict in prompt names, then the prompt at the project level will override the prompt at the user level. 

package/.ai/scripts/fetch_models.js

@@ -0,0 +1,27 @@
+import https from 'node:https';
+
+https.get('https://openrouter.ai/api/v1/models', (res) => {
+  let data = '';
+  res.on('data', (chunk) => {
+    data += chunk;
+  });
+  res.on('end', () => {
+    try {
+      const response = JSON.parse(data);
+      if (response.data && Array.isArray(response.data)) {
+        const model = response.data.find((item) => item.id === 'z-ai/glm-4.5');
+        if (model) {
+          console.info('Model name:', model.name);
+        } else {
+          console.info('Model not found.');
+        }
+      } else {
+        console.error('Invalid response format.');
+      }
+    } catch (error) {
+      console.error('Error parsing response:', error);
+    }
+  });
+}).on('error', (error) => {
+  console.error('Error fetching models:', error);
+});

package/.ai/scripts/generateSystemPrompt.ts

@@ -0,0 +1,15 @@
+import fs from "node:fs";
+import path from "node:path";
+import { systemPrompt } from "../../source/prompts.ts";
+
+const promptContent = await systemPrompt();
+const __dirname = path.dirname(new URL(import.meta.url).pathname);
+const outputDir = path.resolve(__dirname, "../docs");
+const outputFile = path.join(outputDir, "system_prompt.txt");
+
+// Ensure the output directory exists
+if (!fs.existsSync(outputDir)) {
+  fs.mkdirSync(outputDir, { recursive: true });
+}
+
+fs.writeFileSync(outputFile, promptContent, "utf-8");

package/.ai/scripts/list-tools.mjs

@@ -0,0 +1,4 @@
+import { initTools } from "../../source/tools/index.ts";
+(async () => {
+  const _tools = await initTools({});
+})();

package/.ai/scripts/p5_geometric_shapes.js

@@ -0,0 +1,149 @@
+let R = 20; // Radius for shapes
+let spacingX = 55;
+let spacingY = 60;
+let startX = 40;
+let startY = 40;
+
+function setup() {
+  createCanvas(700, 400);
+  background(255);
+  stroke(0);
+  strokeWeight(1.5);
+  noFill();
+  noLoop();
+
+  drawAllRows();
+}
+
+// Draws a regular polygon
+// Default angleOffset = -PI / 2 ensures triangles/pentagons point upwards,
+// and squares are drawn as diamonds (vertices on axes).
+function drawPolygon(x, y, radius, npoints, angleOffset = -PI / 2) {
+  let angle = TWO_PI / npoints;
+  beginShape();
+  for (let i = 0; i < npoints; i++) {
+    let sx = x + cos(i * angle + angleOffset) * radius;
+    let sy = y + sin(i * angle + angleOffset) * radius;
+    vertex(sx, sy);
+  }
+  endShape(CLOSE);
+}
+
+// Draws a star with npoints, using an outer (radius1) and inner (radius2) radius
+function drawStar(x, y, radius1, radius2, npoints, angleOffset = -PI / 2) {
+  let angle = TWO_PI / npoints;
+  let halfAngle = angle / 2.0;
+  beginShape();
+  for (let i = 0; i < npoints; i++) {
+    let outerX = x + cos(i * angle + angleOffset) * radius1;
+    let outerY = y + sin(i * angle + angleOffset) * radius1;
+    vertex(outerX, outerY);
+    let innerX = x + cos(i * angle + halfAngle + angleOffset) * radius2;
+    let innerY = y + sin(i * angle + halfAngle + angleOffset) * radius2;
+    vertex(innerX, innerY);
+  }
+  endShape(CLOSE);
+}
+
+// Draws a hexagram (Star of David) by drawing two offset triangles
+function drawHexagram(x, y, radius) {
+  drawPolygon(x, y, radius, 3, -PI / 2); // Triangle pointing up
+  drawPolygon(x, y, radius, 3, PI / 2); // Triangle pointing down
+}
+
+// Draws an octagram (8-pointed star) by drawing two offset squares
+function drawOctagram(x, y, radius) {
+  // PI / 4 offset gives a square with horizontal/vertical sides
+  drawPolygon(x, y, radius, 4, PI / 4);
+  // 0 offset (or -PI/2, the default for drawPolygon) gives a diamond-oriented square
+  drawPolygon(x, y, radius, 4, 0);
+}
+
+function drawAllRows() {
+  let currentX, currentY;
+
+  // Row 1: Polygons (3 to 12 sides) - 10 shapes
+  // This row should be drawn first, starting from a triangle.
+  currentY = startY;
+  currentX = startX;
+  for (let n = 3; n <= 12; n++) {
+    // For n=4 (square), the default angleOffset (-PI/2) will make it a diamond.
+    drawPolygon(currentX, currentY, R, n);
+    currentX += spacingX;
+  }
+
+  // Row 2: Stars (n=5 to 12 points) - 8 shapes
+  currentY = startY + spacingY;
+  currentX = startX + spacingX; // Indent this row
+  let row2_nPoints = [5, 6, 7, 8, 9, 10, 11, 12];
+  // rFactors define the ratio of inner_radius / outer_radius for drawStar
+  let rFactorsRow2 = {
+    5: 0.38, // Pentagram {5/2}
+    7: 0.55,
+    9: 0.5,
+    10: 0.6,
+    11: 0.55,
+    12: 0.65,
+    // Note: 6 and 8 are handled by drawHexagram and drawOctagram
+  };
+
+  for (let n of row2_nPoints) {
+    if (n === 6) {
+      drawHexagram(currentX, currentY, R);
+    } else if (n === 8) {
+      drawOctagram(currentX, currentY, R); // This should draw the 8-pointed star
+    } else {
+      drawStar(currentX, currentY, R, R * rFactorsRow2[n], n);
+    }
+    currentX += spacingX;
+  }
+
+  // Row 3: Stars (n=7 to 12 points) - 6 shapes
+  currentY = startY + 2 * spacingY;
+  currentX = startX + 2 * spacingX; // Indent further
+  let row3_nPoints = [7, 8, 9, 10, 11, 12];
+  let rFactorsRow3 = {
+    7: 0.6,
+    8: 0.65,
+    9: 0.6,
+    10: 0.7,
+    11: 0.65,
+    12: 0.7,
+    // For n=8 in this row, it will be a star via drawStar, not an octagram like above
+  };
+  for (let n of row3_nPoints) {
+    // If you wanted the 8-pointed star here to also be an octagram, you'd add:
+    // if (n === 8) { drawOctagram(currentX, currentY, R); } else { ... }
+    // But based on the original image, these are general stars.
+    drawStar(currentX, currentY, R, R * rFactorsRow3[n], n);
+    currentX += spacingX;
+  }
+
+  // Row 4: Stars (n=9 to 12 points) - 4 shapes
+  currentY = startY + 3 * spacingY;
+  currentX = startX + 3 * spacingX;
+  let row4_nPoints = [9, 10, 11, 12];
+  let rFactorsRow4 = {
+    9: 0.4,
+    10: 0.45,
+    11: 0.4,
+    12: 0.45,
+  };
+  for (let n of row4_nPoints) {
+    drawStar(currentX, currentY, R, R * rFactorsRow4[n], n);
+    currentX += spacingX;
+  }
+
+  // Row 5: Stars (n=11 to 12 points) - 2 shapes
+  currentY = startY + 4 * spacingY;
+  currentX = startX + 4 * spacingX;
+  let row5_nPoints = [11, 12];
+  let rFactorsRow5 = {
+    11: 0.3,
+    12: 0.3,
+  };
+  for (let n of row5_nPoints) {
+    drawStar(currentX, currentY, R, R * rFactorsRow5[n], n);
+    currentX += spacingX;
+  }
+}

package/.husky/commit-msg

@@ -0,0 +1 @@
+npx --no -- commitlint --edit "$1"

package/.husky/pre-commit

@@ -0,0 +1,3 @@
+npm run lint:staged
+npm run format:staged
+npm run typecheck:staged

package/.husky/pre-push

@@ -0,0 +1 @@
+npm test

package/.ignore

@@ -0,0 +1,4 @@
+.DS_Store
+node_modules/
+dist/
+coverage/

package/AGENTS.md

@@ -0,0 +1,25 @@
+### Commands
+
+- **Build:** `npm run build`
+- **Lint:** `npm run lint`
+- **Lint Single File:** `npm run lint -- path/to/file.ts`
+- **Format:** `npm run format`
+- **Fix Lint/Format:** `npm run lint:fix`
+- **Test:** `npm test`
+- **Run Single Test File:** `node --no-warnings --test test/path/to/your.test.ts`
+- **Find Unused Code/Deps:** `npm run knip`
+
+### Code Style & Guidelines
+
+- **Code Organization:** All source code for this project is stored in `./source`.
+- **Language:** Strict TypeScript (ESNext target). Enable all strict checks.
+- **Modules:** Use ES Modules (`import`/`export`). Add `.ts` extensions to relative imports. Use `node:` prefix for Node.js built-ins (e.g., `import fs from 'node:fs'`).
+- **Formatting/Linting:** Adhere strictly to Biome rules (`npm run format`, `npm run lint`).
+- **Types:** Provide explicit types. Avoid `any` unless absolutely necessary. Always check potentially `undefined`/`null` values. **Do not use non-null assertions (`!`)**.
+- **Naming:** Use camelCase for variables/functions, PascalCase for classes/types/interfaces.
+- **Error Handling:** Implement robust error handling (try/catch, result patterns, etc.).
+- **Logging:** Avoid `console.log` for debugging; use a proper logger or remove before committing.
+- **Commits:** Follow the Conventional Commits standard for commit messages.
+- **Commit Message Length:** Keep commit message lines (header, body, and footer) under 100 characters.
+- **Comments** Never add comments to the code explaining the edit you are making. Comments that help explain how code works are acceptable.
+- **Testing** Use `node:test` and `node:assert/strict` to write unit tests in the `./test` directory. Test directory should follow the same folder structure as source.

package/ARCHITECTURE.md

@@ -0,0 +1,304 @@
+# Acai Architecture
+
+This document outlines the architecture of the Acai CLI tool, a powerful AI-driven software development assistant. It details the project structure, provides descriptions for each file, and illustrates the primary application flows with Mermaid diagrams.
+
+## Project Structure
+
+```
+├── acai-ts
+│   ├── .acai
+│   │   ├── acai.json
+│   │   ├── memory
+│   │   ├── prompts
+│   │   │   ├── project-status.md
+│   │   │   └── update-architecture-document.md
+│   │   ├── rules
+│   │   │   └── learned-rules.md
+│   ├── .gitignore
+│   ├── .husky
+│   │   ├── _
+│   │   │   ├── .gitignore
+│   │   │   ├── applypatch-msg
+│   │   │   ├── commit-msg
+│   │   │   ├── h
+│   │   │   ├── husky.sh
+│   │   │   ├── post-applypatch
+│   │   │   ├── post-checkout
+│   │   │   ├── post-commit
+│   │   │   ├── post-merge
+│   │   │   ├── post-rewrite
+│   │   │   ├── pre-applypatch
+│   │   │   ├── pre-auto-gc
+│   │   │   ├── pre-commit
+│   │   │   ├── pre-merge-commit
+│   │   │   ├── pre-push
+│   │   │   ├── pre-rebase
+│   │   │   └── prepare-commit-msg
+│   │   ├── commit-msg
+│   │   └── pre-commit
+│   ├── .ignore
+│   ├── AGENTS.md
+│   ├── ARCHITECTURE.md
+│   ├── LICENSE
+│   ├── README.md
+│   ├── TODO.md
+│   ├── biome.json
+│   ├── commitlint.config.js
+│   ├── docs
+│   ├── knip.json
+│   ├── package-lock.json
+│   ├── package.json
+│   ├── source
+│   │   ├── cli.ts
+│   │   ├── commands
+│   │   │   ├── application-log-command.ts
+│   │   │   ├── clear-command.ts
+│   │   │   ├── compact-command.ts
+│   │   │   ├── copy-command.ts
+│   │   │   ├── edit-command.ts
+│   │   │   ├── edit-prompt-command.ts
+│   │   │   ├── exit-command.ts
+│   │   │   ├── files-command.ts
+│   │   │   ├── generate-rules-command.ts
+│   │   │   ├── help-command.ts
+│   │   │   ├── init-command.ts
+│   │   │   ├── last-log-command.ts
+│   │   │   ├── manager.ts
+│   │   │   ├── model-command.ts
+│   │   │   ├── paste-command.ts
+│   │   │   ├── prompt-command.ts
+│   │   │   ├── reset-command.ts
+│   │   │   ├── rules-command.ts
+│   │   │   ├── save-command.ts
+│   │   │   ├── types.ts
+│   │   │   ├── usage-command.ts
+│   │   ├── config.ts
+│   │   ├── conversation-analyzer.ts
+│   │   ├── dedent.ts
+│   │   ├── formatting.ts
+│   │   ├── index.ts
+│   │   ├── logger.ts
+│   │   ├── mentions.ts
+│   │   ├── messages.ts
+│   │   ├── middleware
+│   │   │   ├── audit-message.ts
+│   │   │   ├── index.ts
+│   │   │   ├── rate-limit.ts
+│   │   ├── models
+│   │   │   ├── ai-config.ts
+│   │   │   ├── anthropic-provider.ts
+│   │   │   ├── deepseek-provider.ts
+│   │   │   ├── google-provider.ts
+│   │   │   ├── manager.ts
+│   │   │   ├── openai-provider.ts
+│   │   │   ├── openrouter-provider.ts
+│   │   │   ├── providers.ts
+│   │   │   └── xai-provider.ts
+│   │   ├── parsing.ts
+│   │   ├── prompts
+│   │   │   └── manager.ts
+│   │   ├── prompts.ts
+│   │   ├── repl-prompt.ts
+│   │   ├── repl.ts
+│   │   ├── saved-selections
+│   │   ├── terminal
+│   │   │   ├── formatting.ts
+│   │   │   ├── index.ts
+│   │   │   ├── markdown-utils.ts
+│   │   │   ├── markdown.ts
+│   │   │   └── types.ts
+│   │   ├── token-tracker.ts
+│   │   ├── token-utils.ts
+│   │   ├── tools
+│   │   │   ├── agent.ts
+│   │   │   ├── bash.ts
+│   │   │   ├── code-interpreter.ts
+│   │   │   ├── command-validation.ts
+│   │   │   ├── delete-file.ts
+│   │   │   ├── directory-tree.ts
+│   │   │   ├── edit-file.ts
+│   │   │   ├── filesystem-utils.ts
+│   │   │   ├── git-utils.ts
+│   │   │   ├── grep.ts
+│   │   │   ├── index.ts
+│   │   │   ├── memory-read.ts
+│   │   │   ├── memory-write.ts
+│   │   │   ├── move-file.ts
+│   │   │   ├── read-file.ts
+│   │   │   ├── read-multiple-files.ts
+│   │   │   ├── save-file.ts
+│   │   │   ├── think.ts
+│   │   │   ├── types.ts
+│   │   │   ├── web-fetch.ts
+│   │   │   ├── web-search.ts
+│   │   ├── utils
+│   │   │   └── process.ts
+│   ├── test
+│   │   ├── commands
+│   │   │   └── copy-command.test.ts
+│   │   ├── terminal
+│   │   │   └── markdown-utils.test.ts
+│   │   ├── tools
+│   │   │   └── command-validation.test.ts
+│   ├── tsconfig.json
+```
+
+## File Descriptions
+
+| File Path | Description |
+| :--- | :--- |
+| **.acai** | This directory serves as the central location for Acai's internal state, configuration, and temporary files. |
+| **acai.json** | This file contains project-specific configuration for the Acai CLI tool, including custom commands and tool settings. |
+| **learned-rules.md** | This file stores rules learned by Acai based on user corrections and feedback, aiming to improve its future behavior. |
+| **.gitignore** | This file specifies intentionally untracked files and directories that Git should ignore during version control. |
+| **.husky** | Directory for Husky Git hooks configuration |
+| **.ignore** | This file is used by file watching or search tools (like ripgrep) to specify files and directories to ignore beyond `.gitignore`. |
+| **AGENTS.md** | This markdown file contains project-specific rules, guidelines, and commands for Acai to follow. |
+| **ARCHITECTURE.md** | This document outlines the overall architecture and project structure of the Acai CLI tool. |
+| **README.md** | This file provides a comprehensive overview of the Acai project, including its features, installation instructions, usage examples, and configuration details. |
+| **TODO.md** | This markdown file lists tasks or features that are planned for future implementation within the project. |
+| **biome.json** | This file is the configuration for the Biome tool, defining code formatting and linting rules for the project. |
+| **commitlint.config.js** | Configuration file for commitlint to enforce Conventional Commits |
+| **knip.json** | This file is the configuration for Knip, a tool used to detect unused files, dependencies, and exports in the project. |
+| **package-lock.json** | This file records the exact versions of all installed Node.js dependencies, ensuring reproducible builds across different environments. |
+| **package.json** | This file defines project metadata (name, version), dependencies, development scripts, and binary entry points for the Node.js project. |
+| **source/cli.ts** | Command-line interface entry point and argument parsing |
+| **source/commands/** | Directory containing all REPL command implementations |
+| **application-log-command.ts** | Command for viewing application logs |
+| **clear-command.ts** | Implements the `/clear` REPL command to clear the terminal screen |
+| **compact-command.ts** | Implements the `/compact` REPL command to save, summarize, and reset chat history |
+| **copy-command.ts** | Implements `/copy` to copy the last assistant response to the system clipboard |
+| **edit-command.ts** | Command for editing files directly within the REPL |
+| **edit-prompt-command.ts** | Command to modify the current prompt before sending to AI |
+| **exit-command.ts** | Implements the `/exit` command to exit the application |
+| **files-command.ts** | Command to interactively select files and add their content to the prompt |
+| **generate-rules-command.ts** | Command to generate new rules based on conversation analysis |
+| **help-command.ts** | Implements the `/help` command to display usage information |
+| **init-command.ts** | Command to initialize or improve the AGENTS.md file |
+| **last-log-command.ts** | Command to view the most recent application log entries |
+| **manager.ts** | Defines the CommandManager class that registers and routes commands |
+| Registers `/copy` alongside other commands |
+| **model-command.ts** | Command to list available AI models or switch between them |
+| **paste-command.ts** | Implements the `/paste` command to add clipboard contents to the next prompt |
+| **prompt-command.ts** | Command to load previously saved prompts |
+| **reset-command.ts** | Implements the `/reset` command to save and reset chat history |
+| **rules-command.ts** | Command to view/edit persistent project rules and memories |
+| **save-command.ts** | Implements the `/save` command to save current chat history |
+| **types.ts** | Common TypeScript types and interfaces for commands |
+| **usage-command.ts** | Command to display token usage breakdown |
+| **source/config.ts** | Manages configuration files from project and user directories |
+| **source/conversation-analyzer.ts** | Analyzes conversation history to identify user corrections and infer new rules |
+| **source/dedent.ts** | Utility for removing common indentation from multi-line strings |
+| **source/formatting.ts** | Utilities for formatting content consistently in prompts/output |
+| **source/index.ts** | Main entry point for the acai CLI application |
+| **source/logger.ts** | Configures application-wide logging with pino and file transport |
+| **source/mentions.ts** | Handles @mentions in prompts to auto-fetch file/URL content |
+| **source/messages.ts** | Manages conversation log, saving/loading history, and summarization |
+| **source/middleware/** | Directory for middleware components |
+| **audit-message.ts** | Middleware to log AI requests/responses for debugging |
+| **index.ts** | Barrel file exporting middleware components |
+| **rate-limit.ts** | Middleware to enforce rate limits on AI API calls |
+| **source/models/** | Directory for AI model management |
+| **ai-config.ts** | Determines dynamic AI parameters based on model capabilities |
+| **anthropic-provider.ts** | Configuration for Anthropic AI provider |
+| **deepseek-provider.ts** | Configuration for DeepSeek AI provider |
+| **google-provider.ts** | Configuration for Google AI provider |
+| **manager.ts** | ModelManager class for managing AI model registry |
+| **openai-provider.ts** | Configuration for OpenAI provider |
+| **openrouter-provider.ts** | Configuration for OpenRouter AI provider |
+| **providers.ts** | Central registry of supported AI models and helpers |
+| **xai-provider.ts** | Configuration for XAI provider |
+| **source/parsing.ts** | Utilities for data parsing, especially JSON with Zod |
+| **source/prompts/** | Directory for prompt management |
+| **manager.ts** | PromptManager class for managing prompt state |
+| **source/prompts.ts** | Dynamically generates the main system prompt for AI models |
+| **source/repl-prompt.ts** | Implements user input prompt with history and tab completion |
+| **source/repl.ts** | Repl class that orchestrates the main application loop |
+| **source/saved-selections** | Directory for storing saved file selections |
+| **source/terminal/** | Terminal output and formatting utilities |
+| **formatting.ts** | Low-level terminal manipulation functions |
+| **index.ts** | Main Terminal class for formatted console output |
+| **markdown-utils.ts** | Utilities for processing Markdown content |
+| **markdown.ts** | Core logic for Markdown processing |
+| **types.ts** | Type definitions for terminal module |
+| **source/token-tracker.ts** | Tracks and aggregates token usage across AI calls |
+| **source/token-utils.ts** | Utilities for accurate token counting using tiktoken |
+| **source/tools/** | Directory containing all tool implementations |
+| **agent.ts** | Core AI agent logic |
+| **bash.ts** | Executes whitelisted shell commands securely |
+| **code-interpreter.ts** | Executes sandboxed JavaScript code |
+| **command-validation.ts** | Validates CLI commands |
+| **delete-file.ts** | Removes files from the file system |
+| **directory-tree.ts** | Gets directory tree structure |
+| **edit-file.ts** | Modifies file contents with path validation |
+| **filesystem-utils.ts** | General utilities for file system operations |
+| **git-utils.ts** | Utilities for Git operations |
+| **grep.ts** | Searches file contents using ripgrep |
+| **index.ts** | Initializes and exports all tools |
+| **memory-read.ts** | Reads from agent's memory |
+| **memory-write.ts** | Writes to agent's memory |
+| **move-file.ts** | Moves or renames files |
+| **read-file.ts** | Reads file contents |
+| **read-multiple-files.ts** | Reads multiple files efficiently |
+| **save-file.ts** | Writes content to files |
+| **think.ts** | Tool to log AI thought process |
+| **types.ts** | Common types for tool communication |
+| **web-fetch.ts** | Retrieves content from URLs |
+| **web-search.ts** | Performs web searches using Exa API |
+| **source/utils/process.ts** | Robust promise-based wrapper for child_process.execFile |
+| **test/commands/** | Tests for command implementations |
+| **test/terminal/markdown-utils.test.ts** | Tests for markdown utilities |
+| **test/tools/command-validation.test.ts** | Tests for command validation |
+| **tsconfig.json** | TypeScript compiler configuration |
+
+## Flow Diagram
+
+The primary entry point for the Acai CLI is `source/index.ts`, which is compiled to `dist/index.js` and executed via the `acai` binary defined in `package.json`. The application initializes and enters a REPL (Read-Eval-Print Loop) to handle user input.
+
+### Application Initialization and REPL
+
+```mermaid
+graph TD
+    A[Start acai] --> B{source/index.ts};
+    B --> C[Initialize ConfigManager];
+    C --> D[Initialize Logger];
+    D --> E[Initialize ModelManager];
+    E --> F[Initialize MessageHistory];
+    F --> G[Initialize CommandManager];
+    G --> H[Initialize REPL];
+    H --> I{Wait for user input};
+    I --> J{Input starts with "/"?};
+    J -- Yes --> K[Execute Command];
+    J -- No --> L[Process as AI Prompt];
+    K --> I;
+    L --> I;
+```
+
+### AI Prompt Processing
+
+```mermaid
+graph TD
+    A[User enters prompt] --> B{Process Mentions};
+    B --> C[Build System Prompt];
+    C --> D{Select AI Model};
+    D --> E[Send to AI Provider];
+    E --> F{Receive AI Response};
+    F --> G{Response contains tool calls?};
+    G -- Yes --> H[Execute Tools];
+    H --> E;
+    G -- No --> I[Display response to user];
+    I --> A;
+```
+
+### Command Execution (`/` commands)
+
+```mermaid
+graph TD
+    A[User enters command] --> B{CommandManager};
+    B --> C{Find matching command handler};
+    C -- Found --> D[Execute command handler];
+    D --> E[Display output to user];
+    E --> A;
+    C -- Not Found --> F[Display error message];
+    F --> A;
+```