--- description: Skill learned from https://xibeai.in/docs — 12 pages scraped tags: learned, docs, xibecode source: https://xibeai.in/docs --- # xibecode > Learned from [https://xibeai.in/docs](https://xibeai.in/docs) — 12 pages ## Documentation | XibeCode > Source: https://xibeai.in/docs Documentation | XibeCode XibeCode Search ⌘ K Documentation Donate Documentation Installation Quick Start Agent Modes Tools Reference Configuration WebUI AI Test Generation MCP Integration Plugin System Examples & Workflows Documentation Copy page Everything you need to know about using XibeCode — the autonomous AI coding assistant. Everything you need to know about using XibeCode — the autonomous AI coding assistant. Feature Highlights 13 Agent Modes (with interactive Plan Mode) 40+ Built-in Tools Desktop App (Windows, macOS, Linux) Chat History with per-project persistence MCP Protocol Support Open Source (Apache 2.0) Dependency Map Getting Started Installation Install XibeCode and set up your API key in under a minute. Quick Start Run your first autonomous coding task with XibeCode. Desktop App Download the native desktop app for Windows, macOS, and Linux. WebUI Browser-based interface with dashboard, visual diff, and chat. Core Features Agent Modes Discover 13 specialized AI personas for different tasks. Tools Reference Explore 40+ built-in tools for autonomous coding. Configuration Customize models, API endpoints, package managers, and more. Advanced MCP Integration Connect to external servers via the Model Context Protocol. Plugins Extend XibeCode with custom tools and domain-specific logic. Examples Real-world use cases, workflows, and tips. Quick Links GitHub Repository npm Package Desktop App Downloads Installation Guide Desktop App WebUI Documentation Agent Modes (13 Personas) Tools Reference (40+ Tools) Example Use Cases New to XibeCode? Start with the Quick Start guide to run your first autonomous coding task, then explore the Agent Modes to discover the 13 specialized AI personas. Installation Get XibeCode up and running in under a minute. Install via npm, pnpm, bun, yarn, or from source. On this page Feature Highlights Dependency Map Getting Started Core Features Advanced Quick Links Ctrl+I Assistant How can I help? Ask me about configuration, installation, or specific features. --- ## Installation | XibeCode > Source: https://xibeai.in/docs/installation Installation | XibeCode XibeCode Search ⌘ K Documentation Donate Documentation Installation Quick Start Agent Modes Tools Reference Configuration WebUI AI Test Generation MCP Integration Plugin System Examples & Workflows Installation Copy page Get XibeCode up and running in under a minute. Install via npm, pnpm, bun, yarn, or from source. Get XibeCode up and running in under a minute. Desktop App Available Want a native desktop experience? Download the XibeCode Desktop App for Windows, macOS, and Linux after installing the CLI. Requirements Node.js 18.0.0 or higher TypeScript 5.3+ (for development) An AI provider API key (Anthropic, OpenAI, or compatible) Install from npm (Recommended) npm install -g xibecode Or use your preferred package manager: # pnpm (recommended) pnpm add -g xibecode # bun bun add -g xibecode # yarn yarn global add xibecode Install from Source git clone https://github.com/iotserver24/Xibecode cd Xibecode npm install npm run build npm link Set up API Key XibeCode needs an AI provider API key (Anthropic, OpenAI, or compatible). You can set it up in three ways: Option 1: Interactive Setup (Recommended) xibecode config This opens an interactive menu where you can configure all settings including API key, model, and preferences. Option 2: Direct Configuration # Set API key xibecode config --set-key YOUR_ANTHROPIC_API_KEY # Or for OpenAI xibecode config --set-key YOUR_OPENAI_API_KEY Option 3: Environment Variable # Anthropic export ANTHROPIC_API_KEY = your_key_here # OpenAI export OPENAI_API_KEY = your_key_here Verify Installation # Check version xibecode --version # View current configuration xibecode config --show # Run a simple test xibecode chat Directory Structure XibeCode creates the following directories: ~/.xibecode/ # Global configuration ├── config.json # Main configuration file ├── mcp-servers.json # MCP server configurations └── backups/ # File backups .xibecode/ # Project-level (in your working directory) ├── memory.json # Neural memory for this project └── skills/ # Custom skills for this project Supported Platforms macOS — Full support (Intel and Apple Silicon) Linux — Full support (Ubuntu, Debian, Fedora, Arch) Windows — Full support (PowerShell and WSL) Troubleshooting Permission Denied on Global Install # Use sudo (not recommended) sudo npm install -g xibecode # Better: Fix npm permissions mkdir ~/.npm-global npm config set prefix '~/.npm-global' export PATH =~ /.npm-global/bin:$PATH Node.js Version Too Old # Using nvm (Node Version Manager) nvm install 18 nvm use 18 # Verify node --version API Key Not Working # Check if key is set xibecode config --show # Test API connection xibecode chat # Then type: "Hello" to test Next Steps Quick Start Guide — Run your first autonomous coding task Configuration — Customize XibeCode for your workflow Agent Modes — Learn about the 13 specialized agent personas Documentation Everything you need to know about using XibeCode — the autonomous AI coding assistant. Quick Start Get productive with XibeCode in minutes. Run your first autonomous coding session with the run and chat commands. On this page Requirements Install from npm (Recommended) Install from Source Set up API Key Option 1: Interactive Setup (Recommended) Option 2: Direct Configuration Option 3: Environment Variable Verify Installation Directory Structure Supported Platforms Troubleshooting Permission Denied on Global Install Node.js Version Too Old API Key Not Working Next Steps Ctrl+I Assistant How can I help? Ask me about configuration, installation, or specific features. --- ## Quick Start | XibeCode > Source: https://xibeai.in/docs/quickstart Quick Start | XibeCode XibeCode Search ⌘ K Documentation Donate Documentation Installation Quick Start Agent Modes Tools Reference Configuration WebUI AI Test Generation MCP Integration Plugin System Examples & Workflows Quick Start Copy page Get productive with XibeCode in minutes. Run your first autonomous coding session with the run and chat commands. Get productive with XibeCode in minutes. This guide walks you through your first autonomous coding session and introduces you to the key features. Your First Task The run command lets XibeCode autonomously complete coding tasks. Just describe what you want: xibecode run "Create a Python script that prints hello world" XibeCode will read your project, create the file, and verify it works — all autonomously. Interactive Chat For iterative development and quick questions, use chat mode: xibecode chat In chat mode you can: Ask questions about your codebase Request code changes step by step Switch between agent personas with /mode Toggle tool execution with tools on/off Type exit or quit to leave Agent Modes (Personas) XibeCode features 13 specialized agent personas, each optimized for different tasks. Switch modes to get specialized assistance: # In chat mode, switch personas /mode plan # Aria the Architect - planning and analysis /mode agent # Default mode - full coding capabilities /mode debugger # Dex the Detective - bug hunting and fixing /mode tester # Tess the QA Engineer - testing and quality /mode security # Sentinel the Guardian - security audits /mode review # Nova the Critic - code reviews Key Personas Mode Persona Best For agent Default Agent Full-stack development, building features plan Aria the Architect Understanding codebases, planning implementations debugger Dex the Detective Finding and fixing bugs tester Tess the QA Engineer Writing tests, ensuring quality security Sentinel the Guardian Security audits, vulnerability detection Run Command Options xibecode run [prompt] [options] Options: -f, --file < pat h > Read prompt from a file -m, --model < mode l > AI model to use (default: claude-sonnet-4-5-20250929 ) -b, --base-url < ur l > Custom API base URL -k, --api-key < ke y > API key (overrides config ) -d, --max-iterations < nu m > Maximum iterations (default: 50 ) -v, --verbose Show detailed logs --dry-run Preview changes without making them --changed-only Focus only on git-changed files --mode < mod e > Start in a specific agent mode Example Tasks Build a Feature xibecode run "Add user authentication to the Express API: - POST /auth/register - POST /auth/login - JWT token generation - Middleware to protect routes" Fix a Bug xibecode run "The tests in test/user.test.js are failing. Debug and fix the issues." --verbose Refactor Code xibecode run "Refactor src/ to use TypeScript: - Convert all .js files to .ts - Add type annotations - Create types.ts for shared types" Generate Tests xibecode run "Write comprehensive tests for userController.js: - Test all endpoints - Test error cases - Use Jest - Achieve >80% coverage" Preview Changes (Dry Run) xibecode run "Refactor authentication module" --dry-run Focus on Changed Files xibecode run "Fix linting errors in changed files" --changed-only Use a Specific Mode # Start in planning mode xibecode run "Analyze this codebase and suggest improvements" --mode plan # Start in debugging mode xibecode run "Find the bug causing the API timeout" --mode debugger How XibeCode Works When you give XibeCode a task, it follows this autonomous loop: Read — Analyzes your project structure, re ...(truncated) --- ## Agent Modes | XibeCode > Source: https://xibeai.in/docs/modes Agent Modes | XibeCode XibeCode Search ⌘ K Documentation Donate Documentation Installation Quick Start Agent Modes Tools Reference Configuration WebUI AI Test Generation MCP Integration Plugin System Examples & Workflows Agent Modes Copy page 13 specialized agent personas, each optimized for different development tasks. Switch between plan, agent, debugger, tester, security, review, engineer, architect, team leader, researcher, seo, product, and data modes. XibeCode features 13 specialized agent modes (personas), each optimized for different types of tasks. Each mode has a unique personality, set of allowed tools, and behavioral characteristics. Quick Reference Mode Persona Best For Can Modify agent (Default) Full-stack development Yes plan Strategic Planner Interactive planning with web research Yes (implementations.md only) debugger Dex the Detective Bug hunting, fixing Yes tester Tess the QA Engineer Testing, quality Yes security Sentinel the Guardian Security audits No review Nova the Critic Code reviews No engineer Alex the Implementer Feature implementation Yes architect Anna the Designer System design Yes team_leader Arya the Leader Task orchestration Yes researcher Sanvi the Scholar Deep research Yes seo Siri the Optimizer SEO, web optimization Yes product Agni the Strategist Product strategy Yes data David the Analyst Data analysis Yes Switching Modes # Via CLI flag xibecode run "task" --mode plan xibecode run "task" --mode debugger # In chat mode xibecode chat > /mode plan > /mode agent Development Modes Agent Mode (Default) Full autonomous coding with all capabilities enabled. Best For: Building new features, full-stack development, multi-step coding tasks, installing dependencies, running tests and commands. Capabilities: Read and modify files, create new files and directories, run shell commands, execute tests, git operations (read and write), web search and fetch. xibecode run "Add a user authentication system" --mode agent Engineer Mode Persona: Alex the Implementer Focused implementation mode for building features. Best For: Implementing specific features, writing clean maintainable code, following specifications, writing tests for implementations. xibecode run "Implement the checkout flow" --mode engineer Planning & Analysis Modes Plan Mode Persona: Strategic Planner Interactive planning mode with web research, clarifying questions, and structured implementations.md generation. Best For: Creating detailed implementation plans, researching solutions, breaking down complex features into tasks, generating step-by-step plans with code snippets. How It Works: Reads the codebase and researches online Asks clarifying questions (multiple-choice in WebUI, inquirer prompts in CLI) Generates implementations.md with checkbox tasks, file paths, and code snippets Shows a plan preview with "View Plan" and "Build" buttons On "Build", switches to Agent mode to execute the plan automatically Tools Available: File reading, web search, fetch URL, git read, context search, and write to implementations.md only. xibecode run "Plan how to add authentication to this app" --mode plan Architect Mode Persona: Anna the Designer System design and high-level architecture planning. Best For: System design documents, component architecture, tech stack selection, design patterns, scalability planning. xibecode run "Design the microservices architecture" --mode architect Researcher Mode Persona: Sanvi the Scholar Deep research and investigation mode. Best For: Investigating complex topics, reading documentation, analyzing papers and specs, synthesizing information. xibecode run "Research best practices for API rate limiting" --mode researcher Quality & Testing Modes Debugger Mode Persona: Dex the Detective Systematic debugging and root cause an ...(truncated) --- ## Tools Reference | XibeCode > Source: https://xibeai.in/docs/tools Tools Reference | XibeCode XibeCode Search ⌘ K Documentation Donate Documentation Installation Quick Start Agent Modes Tools Reference Configuration WebUI AI Test Generation MCP Integration Plugin System Examples & Workflows Tools Reference Copy page 40+ built-in tools across 8 categories for autonomous coding operations. File operations, git, shell, web search, testing, browser automation, memory, and more. XibeCode provides 40+ built-in tools across 8 categories for autonomous coding operations. These tools are automatically available to the AI agent based on the current mode's permissions. Tool Categories Overview Category Tools Description File Operations 8 Read, write, edit, delete files Directory Operations 3 List, search, create, move Git Operations 7 Status, diff, checkpoints, revert Shell & Code Search 2 Execute commands, grep code Web Operations 2 Search, fetch URLs Test Operations 4 Run tests, generate tests, analyze code Memory Operations 2 Neural memory updates Browser Operations 8 Screenshots, testing, performance, accessibility File Operations read_file Read the contents of a file. { "path" : "src/app.ts" , "start_line" : 1 , "end_line" : 100 } read_multiple_files Read multiple files at once for context. { "paths" : [ "src/app.ts" , "src/utils.ts" , "package.json" ] } write_file Write content to a file (creates or overwrites). { "path" : "src/new-file.ts" , "content" : "export const hello = 'world';" } edit_file Edit a file using search and replace. { "path" : "src/app.ts" , "search" : "const oldValue = 1;" , "replace" : "const newValue = 2;" } edit_lines Edit specific line ranges in a file. { "path" : "src/app.ts" , "start_line" : 10 , "end_line" : 15 , "content" : "// New content" } insert_at_line Insert content at a specific line. { "path" : "src/app.ts" , "line" : 5 , "content" : "import { newModule } from './module';" } verified_edit Edit with verification — ensures the search pattern exists before replacing. { "path" : "src/app.ts" , "search" : "exact content to find" , "replace" : "replacement content" } delete_file Delete a file. { "path" : "src/deprecated.ts" } Directory Operations list_directory { "path" : "src/" , "recursive" : false } search_files { "pattern" : "*.ts" , "path" : "src/" } create_directory { "path" : "src/new-feature/" } move_file { "source" : "src/old-name.ts" , "destination" : "src/new-name.ts" } Git Operations get_git_status Returns staged, unstaged, and untracked files. get_git_diff_summary { "staged" : true } get_git_changed_files Get list of files changed in the current branch. create_git_checkpoint { "message" : "before auth refactor" , "strategy" : "stash" } revert_to_git_checkpoint { "checkpoint_id" : "stash@{0}" } git_show_diff { "path" : "src/app.ts" } get_mcp_status Get MCP server status. Shell Commands run_command { "command" : "npm install express" , "cwd" : "./" , "timeout" : 30000 , "stdin" : "input data" } Dangerous commands like rm -rf / are blocked automatically. Code Search grep_code { "pattern" : "function.*async" , "path" : "src/" , "include" : "*.ts" , "case_sensitive" : false } Web Operations web_search { "query" : "typescript best practices 2024" , "num_results" : 5 } fetch_url { "url" : "https://api.example.com/data" , "method" : "GET" } Test Operations run_tests { "path" : "src/" , "filter" : "auth" , "verbose" : true } Supports: Vitest, Jest, Mocha, pytest, Go test, Cargo test. get_test_status Returns passed, failed, and skipped test counts. Memory Operations update_memory { "key" : "project_structure" , ...(truncated) --- ## Configuration | XibeCode > Source: https://xibeai.in/docs/configuration Configuration | XibeCode XibeCode Search ⌘ K Documentation Donate Documentation Installation Quick Start Agent Modes Tools Reference Configuration WebUI AI Test Generation MCP Integration Plugin System Examples & Workflows Configuration Copy page Customize models, API endpoints, package managers, and all XibeCode settings. 23 config options including apiKey, model, maxIterations, and more. XibeCode stores its configuration in ~/.xibecode/ . You can manage settings via the CLI or by editing the config file directly. Interactive Setup xibecode config This opens an interactive menu to configure all settings including API key, model, package manager, default mode, and safety settings. Quick Commands # Set API key xibecode config --set-key YOUR_ANTHROPIC_API_KEY # Set custom API endpoint xibecode config --set-url https://your-custom-endpoint.com # Set default model xibecode config --set-model claude-sonnet-4-5-20250929 # View current config xibecode config --show # Reset all settings xibecode config --reset Configuration File The main configuration file is located at ~/.xibecode/config.json : { "apiKey" : "sk-ant-..." , "baseUrl" : "https://api.anthropic.com" , "model" : "claude-sonnet-4-5-20250929" , "maxIterations" : 50 , "defaultVerbose" : false , "preferredPackageManager" : "pnpm" , "enableDryRunByDefault" : false , "gitCheckpointStrategy" : "stash" , "defaultMode" : "agent" , "autoApprovalPolicy" : "always" , "plugins" : [], "mcpServers" : {} } Configuration Options Setting Description Default apiKey Your AI provider API key (Anthropic, OpenAI) — baseUrl Custom API endpoint (Azure, AWS Bedrock, etc.) Anthropic default model Default AI model to use claude-sonnet-4-5-20250929 maxIterations Maximum autonomous iterations before stopping 50 defaultVerbose Enable verbose logging by default false preferredPackageManager Package manager: pnpm, bun, npm, or yarn pnpm enableDryRunByDefault Run in dry-run mode by default false gitCheckpointStrategy Git checkpoint method: stash or commit stash defaultMode Default agent mode to start in agent autoApprovalPolicy Mode transition approval: always, prompt-only, never always testCommandOverride Custom test command (overrides auto-detection) Auto-detected plugins Array of plugin file paths [] mcpServers MCP server configurations {} Environment Variables # API Keys ANTHROPIC_API_KEY = your_key # Anthropic API key OPENAI_API_KEY = your_key # OpenAI API key # API Configuration ANTHROPIC_BASE_URL = https://... # Custom endpoint XIBECODE_MODEL = claude-opus-4-... # Default model # Behavior XIBECODE_DRY_RUN = true # Enable dry-run by default XIBECODE_VERBOSE = true # Enable verbose logging XIBECODE_MODE = plan # Default agent mode Priority Order Configuration is resolved in this order (highest priority first): CLI flags (e.g., --api-key , --model ) Environment variables Project-level config ( .xibecode/config.json ) Global config file ( ~/.xibecode/config.json ) Agent Mode Configuration { "defaultMode" : "agent" , "autoApprovalPolicy" : "prompt-only" } Auto-approval policies: always — Auto-approve all mode transitions prompt-only — Require confirmation for escalation (read -> write) always-for-debugger — Auto-approve only debugger transitions never — Always require confirmation Custom API Endpoints XibeCode supports custom API endpoints, making it compatible with Azure OpenAI, AWS Bedrock, or any Claude-compatible API: # Via config xibecode config --set-url https://your-custom-endpoint.com # Via CLI flag xibecode run "task" --base-url https://your-custom-endpoint.com # Via environment variable export ANTHROPIC_BASE_URL = https://your-custom-endpoint.com Az ...(truncated) --- ## WebUI | XibeCode > Source: https://xibeai.in/docs/webui WebUI | XibeCode XibeCode Search ⌘ K Documentation Donate Documentation Installation Quick Start Agent Modes Tools Reference Configuration WebUI AI Test Generation MCP Integration Plugin System Examples & Workflows WebUI Copy page A browser-based interface that syncs in real-time with the terminal. Features Monaco editor, multi-terminal, Git panel, settings modal, file explorer, and real-time AI chat. A browser-based interface that syncs in real-time with the terminal. Chat, switch modes, reference files, and configure settings — all from your browser. Prefer a native app? The WebUI is also available as a Desktop App for Windows, macOS, and Linux — same interface, native window. Quick Start # Start the WebUI xibecode ui --open # Or start chat (WebUI opens automatically) xibecode chat # WebUI runs at http://localhost:3847 Screenshots Main Interface Modern v0.dev-inspired interface with activity bar, chat panel, code editor, and terminal. File Explorer Browse and open files with recursive directory tree. Chat Interface Interactive AI chat with streaming responses and markdown rendering. Git Panel Git integration with commit history, staging, and diffs. Settings Panel Comprehensive settings modal with multiple configuration categories. AI Provider Settings Configure AI models, API keys, and provider settings. MCP Servers Editor Edit MCP server configuration with Monaco editor and syntax highlighting. Terminal View Fully interactive terminal with PTY support, colors, and tab completion. New in v0.5.0 Interactive Plan Mode - Plan mode asks questions, searches the web, generates implementations.md , and has "Build" to auto-execute Chat History - Persistent conversations with per-project storage, History panel in activity bar Environment Variables Editor - Visual .env editor with auto-detection, secret masking, live editing Media Preview - Images, videos, audio render as proper previews instead of binary Thinking Animation - Loading spinner while AI processes requests Improved Tool Rendering - Icons, status badges, and progress indicators for tool calls Smart Scroll - No more forced scrolling when reading earlier messages Donate Button - Support XibeCode from the activity bar Previous (v0.4.x) TUI-WebUI bidirectional sync Slash commands for mode switching @ file references Custom model/endpoint support Tool execution display Minimalistic terminal design TUI-WebUI Sync When you run xibecode chat , both the terminal and browser interfaces are connected in real-time: From TUI to WebUI: Messages appear with "(TUI)" label Streaming responses show live Tool calls display in real-time From WebUI to TUI: Messages processed by TUI agent Full tool access and execution Responses stream to both interfaces Slash Commands Type / in the input to open the command palette. Use arrow keys to navigate and Enter to select. Command Description /clear Clear chat messages /help Show available commands and tips /diff Show git diff /status Show git status /test Run project tests /format Format code in project /reset Reset chat session /files List project files Agent Modes in WebUI Mode Icon Description /mode agent 🤖 Autonomous coding (default) /mode plan 📝 Interactive planning with web research /mode tester 🧪 Testing and QA /mode debugger 🐛 Bug investigation /mode security 🔒 Security analysis /mode review 👀 Code review /mode team_leader 👑 Coordinate team of agents /mode architect 🏛️ System design /mode engineer 🛠️ Implementation /mode seo 🌐 SEO optimization /mode product 🔥 Product strategy /mode data 📊 Data analysis /mode researcher 📚 Deep research File References Type @ in the input to browse and reference project files: Shows files and folders in your project Type after @ to filter (e.g., @src/ ) Use arrow keys to navigate, Enter to select Selected file path is inserted into yo ...(truncated) --- ## AI Test Generation | XibeCode > Source: https://xibeai.in/docs/test-generation AI Test Generation | XibeCode XibeCode Search ⌘ K Documentation Donate Documentation Installation Quick Start Agent Modes Tools Reference Configuration WebUI AI Test Generation MCP Integration Plugin System Examples & Workflows AI Test Generation Copy page Automatically generate comprehensive test suites for your code using AI-powered analysis. Supports Vitest, Jest, Mocha, pytest, and Go test. Automatically generate comprehensive test suites for your code using AI-powered analysis. Quick Start Via CLI (in chat mode) xibecode chat > generate tests for src/utils/helpers.ts Via WebUI Open the WebUI: xibecode ui --open Go to the "Test Generator" tab Enter file path Click "Generate Tests" Supported Frameworks Framework Language Features Vitest JavaScript/TypeScript describe/it blocks, vi.mock() setup, expect assertions Jest JavaScript/TypeScript describe/it blocks, jest.mock() setup, expect assertions Mocha JavaScript/TypeScript describe/it blocks, Sinon mocks, Chai assertions pytest Python class TestX format, Mock/patch setup, assert statements Go test Go func TestX format, testify/mock, assert package Auto-detect Any Reads package.json, checks dependencies, falls back to Vitest Features Code Analysis — Understands functions, classes, types, imports, and exports. Detects complexity and dependencies. Edge Case Generation — Automatically generates tests for null values, empty strings, boundary conditions, and error cases. Type Checking — Creates assertions for return types, ensuring functions return expected data types. Mock Setup — Automatically configures mocks for dependencies and external modules. Tool API generate_tests Analyze a source file and generate comprehensive test cases. Parameter Type Description file_path string Path to source file (required) framework string vitest, jest, mocha, pytest, go (auto-detected) output_dir string Custom output directory for tests include_edge_cases boolean Include edge case tests (default: true) include_mocks boolean Include mock setup code (default: true) max_tests_per_function number Maximum tests per function (default: 5) write_file boolean Write to file (default: false) analyze_code_for_tests Analyze a source file to understand its structure before generating tests. Parameter Type Description file_path string Path to source file (required) Example Output Given a file with a calculateTotal function: import { describe, it, expect, vi } from 'vitest' ; import { calculateTotal } from '../utils/helpers' ; beforeEach (() => { vi. clearAllMocks (); }); describe ( 'calculateTotal' , () => { it ( 'should execute calculateTotal successfully' , () => { expect ( calculateTotal ([])). toBeDefined (); }); it ( 'should return correct type from calculateTotal' , () => { expect ( typeof calculateTotal ([])). toBe ( 'number' ); }); it ( 'should handle empty array' , () => { expect ( calculateTotal ([])). toBe ( 0 ); }); it ( 'should handle single element' , () => { expect ( calculateTotal ([ 10 ])). toBe ( 10 ); }); it ( 'should handle errors in calculateTotal' , () => { expect (() => calculateTotal ( undefined )). toThrow (); }); }); Generated Test Types Type Description Example unit Basic functionality tests Function returns expected value edge Edge case and boundary tests Empty string, null, MAX_INT boundary Boundary condition tests Array length 0, 1, MAX error Error handling tests Invalid input throws error Best Practices Review generated tests — AI-generated tests are a starting point, not the final product Add domain-specific assertions — The generator may miss business logic requirements Use write_file: false fir ...(truncated) --- ## MCP Integration | XibeCode > Source: https://xibeai.in/docs/mcp MCP Integration | XibeCode XibeCode Search ⌘ K Documentation Donate Documentation Installation Quick Start Agent Modes Tools Reference Configuration WebUI AI Test Generation MCP Integration Plugin System Examples & Workflows MCP Integration Copy page Connect to external servers via the Model Context Protocol for databases, APIs, file systems, and more. Configure GitHub, PostgreSQL, Slack, filesystem, and custom MCP servers. XibeCode supports the Model Context Protocol (MCP) , an open protocol that standardizes how applications provide context to LLMs. Connect to external servers for databases, APIs, file systems, and more. What is MCP? MCP enables: Extended Tools — Add tools from external servers (databases, APIs, etc.) Access Resources — Read data from external sources Prompt Templates — Use pre-built prompts from servers Context Sharing — Share context between different AI tools Quick Start # Initialize MCP configuration xibecode mcp init # Add a server xibecode mcp add # List configured servers xibecode mcp list # Reload after editing xibecode mcp reload Adding MCP Servers File-Based Configuration (Recommended) # Show the config file path xibecode mcp file # Open in your default editor xibecode mcp edit Configuration Format { "mcpServers" : { "filesystem" : { "command" : "mcp-server-filesystem" , "args" : [ "--root" , "/path/to/files" ] }, "github" : { "command" : "mcp-server-github" , "env" : { "GITHUB_TOKEN" : "your_token_here" } }, "postgres" : { "command" : "mcp-server-postgres" , "env" : { "DATABASE_URL" : "postgresql://user:pass@localhost/db" } } } } MCP Commands xibecode mcp init # Initialize default config xibecode mcp add # Add a server xibecode mcp edit # Edit configuration xibecode mcp list # List configured servers xibecode mcp remove # Remove a server xibecode mcp reload # Reload after editing xibecode mcp file # Show file path xibecode mcp status # Check connection status Using MCP Tools Once configured, MCP tools are automatically available. Tools are prefixed with the server name: filesystem::read_file github::create_issue github::list_repos postgres::query slack::send_message In chat mode, view MCP tools: xibecode chat > /mcp # Show MCP status and tools > /mcp list # List all MCP tools > /mcp reload # Reload MCP servers Server Configuration Options Option Description Required command The command to start the MCP server Yes args Array of command-line arguments No env Environment variables for the server No cwd Working directory for the server No Example Configurations GitHub MCP Server npm install -g @modelcontextprotocol/server-github { "mcpServers" : { "github" : { "command" : "mcp-server-github" , "env" : { "GITHUB_TOKEN" : "ghp_your_token_here" } } } } xibecode chat > Create an issue about the login bug in the main repo PostgreSQL MCP Server npm install -g @modelcontextprotocol/server-postgres { "mcpServers" : { "postgres" : { "command" : "mcp-server-postgres" , "env" : { "DATABASE_URL" : "postgresql://user:pass@localhost:5432/mydb" } } } } Filesystem MCP Server npm install -g @modelcontextprotocol/server-filesystem { "mcpServers" : { "docs" : { "command" : "mcp-server-filesystem" , "args" : [ "--root" , "/path/to/documentation" ] } } } Slack MCP Server { "mcpServers" : { "slack" : { "command" : "mcp-server-slack" , "env" : { "SLACK_BOT_TOKEN" : "xoxb-your-token" , "SLACK_TEAM_ID" : "T01234567" ...(truncated) --- ## Plugin System | XibeCode > Source: https://xibeai.in/docs/plugins Plugin System | XibeCode XibeCode Search ⌘ K Documentation Donate Documentation Installation Quick Start Agent Modes Tools Reference Configuration WebUI AI Test Generation MCP Integration Plugin System Examples & Workflows Plugin System Copy page Extend XibeCode with custom tools and domain-specific logic. Create JavaScript or TypeScript plugins with registerTools, initialize, and cleanup hooks. XibeCode's plugin system lets you extend the AI with custom tools and domain-specific logic. Plugins are JavaScript/TypeScript modules that register new tool definitions. Why Use Plugins? Custom Tools — Add tools specific to your workflow Domain Logic — Integrate with internal APIs and services Automation — Create deployment, testing, or CI/CD tools Data Access — Connect to databases, APIs, or file systems Quick Start # 1. Create a plugin file touch my-plugin.js # 2. Add to config (~/.xibecode/config.json) # "plugins": ["/path/to/my-plugin.js"] # 3. Reload XibeCode xibecode chat > /reload Creating a Plugin A plugin exports a default object with metadata and a registerTools() method: export default { name: 'my-custom-plugin' , version: '1.0.0' , description: 'Adds custom tools for my workflow' , registerTools () { return [ { schema: { name: 'deploy_to_staging' , description: 'Deploy the app to staging environment' , input_schema: { type: 'object' , properties: { branch: { type: 'string' , description: 'Branch to deploy' }, force: { type: 'boolean' , description: 'Force deploy' } }, required: [ 'branch' ] } }, async handler ( input ) { console. log ( `Deploying ${ input . branch } to staging...` ); await new Promise ( resolve => setTimeout (resolve, 2000 )); return { success: true , url: 'https://staging.example.com' }; } } ]; }, initialize () { console. log ( 'Plugin loaded!' ); }, cleanup () { console. log ( 'Plugin unloaded!' ); } }; Loading Plugins Add plugin paths to your config: { "plugins" : [ "/absolute/path/to/my-plugin.js" , "./relative/path/to/plugin.js" , "~/plugins/deploy-plugin.js" ] } Plugin API Property Type Required Description name string Yes Unique plugin identifier version string Yes Semver version string description string Yes What the plugin does registerTools() Tool[] Yes Returns array of tool definitions initialize() void No Setup hook cleanup() void No Cleanup hook Tool Schema Each tool follows the Anthropic tool use schema: { schema : { name : 'tool_name' , description : 'What it does' , input_schema : { type : 'object' , properties : { param1 : { type : 'string' , description : 'Description' }, param2 : { type : 'number' , description : 'Description' }, param3 : { type : 'boolean' , description : 'Description' }, param4 : { type : 'array' , items : { type : 'string' }, description : 'List' } }, required : [ 'param1' ] } }, handler : async ( input ) => { return { result: '...' }; } } Plugin Examples Deployment Plugin export default { name: 'deploy-plugin' , version: '1.0.0' , description: 'Deployment tools for staging and production' , registerTool ...(truncated) --- ## Examples & Workflows | XibeCode > Source: https://xibeai.in/docs/examples Examples & Workflows | XibeCode XibeCode Search ⌘ K Documentation Donate Documentation Installation Quick Start Agent Modes Tools Reference Configuration WebUI AI Test Generation MCP Integration Plugin System Examples & Workflows Examples & Workflows Copy page Real-world examples showing how to use XibeCode for common development tasks. Build features, fix bugs, refactor, test, review, and automate with 20+ examples. Real-world examples showing how to use XibeCode for common development tasks. Each example demonstrates autonomous AI-assisted coding. Building Features Add User Authentication xibecode run "Add JWT authentication: 1. Install jsonwebtoken and bcrypt 2. Create auth middleware 3. Add /login and /register endpoints 4. Protect existing routes 5. Add tests" Create a REST API xibecode run "Create a REST API with Express for a todo app: - GET /todos - List all todos - POST /todos - Create a todo - PUT /todos/:id - Update a todo - DELETE /todos/:id - Delete a todo - Add input validation - Include error handling" Add Database Integration xibecode run "Add PostgreSQL database integration: - Set up Prisma ORM - Create user and post models - Add migration scripts - Create seed data" Build a React Component xibecode run "Create a DataTable component in React: - Sortable columns - Pagination - Search/filter functionality - Loading and empty states - Use TypeScript and Tailwind CSS" Fixing Bugs Debug Failing Tests xibecode run "The tests in test/user.test.js are failing. Debug and fix." --verbose --mode debugger Dex the Debugger will: run tests, read source code, identify root cause, apply minimal fix, re-run tests to verify. Fix a Production Error xibecode run "Production error: 'Cannot read property x of undefined' in userController.js line 42. Fix it." --verbose --mode debugger Fix Type Errors xibecode run "Fix all TypeScript errors in the src/ directory" --verbose Fix Linting Errors xibecode run "Fix linting errors in changed files" --changed-only Memory Leak Investigation xibecode run "There's a memory leak in the WebSocket handler. Investigate and fix it." --mode debugger --verbose Refactoring Convert to TypeScript xibecode run "Refactor src/ to use TypeScript: - Convert all .js files to .ts - Add type annotations - Create types.ts for shared types - Update tsconfig.json - Fix any type errors" Improve Code Quality xibecode run "Refactor the authentication module to follow SOLID principles" Extract Common Logic xibecode run "Extract duplicate validation logic into a shared utils file: - Find all validation patterns - Create a validation.ts utility - Update all files to use the new utility - Add tests for the utility" Modernize Legacy Code xibecode run "Modernize the callback-based API to use async/await: - Convert callbacks to Promises - Use async/await syntax - Maintain backwards compatibility - Update tests" Testing Generate Tests for a Module xibecode run "Write comprehensive tests for userController.js: - Test all endpoints - Test error cases and edge cases - Test validation - Use Jest - Achieve >80% coverage" --mode tester Add Integration Tests xibecode run "Add integration tests for the checkout flow: - Test the complete purchase flow - Test payment processing - Test inventory updates - Test email notifications" --mode tester Fix Flaky Tests xibecode run "The test 'should handle concurrent requests' is flaky. Investigate and fix it." --mode debugger Code Review & Security Security Audit xibecode run "Perform a security audit on the auth module: - Check for injection vulnerabilities - Review authentication flow - Check for data exposure risks - Suggest improvements" --mode security Code Review xibecode run "Review the recent changes in the payment module: - Check code qualit ...(truncated) --- ## Desktop App | XibeCode > Source: https://xibeai.in/docs/desktop Desktop App | XibeCode XibeCode Search ⌘ K Documentation Donate Documentation Installation Quick Start Agent Modes Tools Reference Configuration WebUI AI Test Generation MCP Integration Plugin System Examples & Workflows Desktop App Copy page Download the XibeCode desktop app for Windows, macOS, and Linux. A native IDE-like experience powered by the xibecode CLI. The XibeCode Desktop App gives you a native IDE-like experience with a VS Code-style welcome screen, recent projects, and the full XibeCode WebUI in a native window. Download Download the latest release from GitHub Releases . Platform Architecture Format Download Windows x64 .exe Download Windows arm64 .exe Download macOS Intel (x64) .dmg Download macOS Apple Silicon (arm64) .dmg Download Linux x64 .deb .rpm .AppImage Download Linux arm64 .deb .rpm .AppImage Download Prerequisites The desktop app requires the xibecode CLI to be installed globally: npm install -g xibecode xibecode config --set-key YOUR_API_KEY How It Works The desktop app is a thin Electron shell (~5MB) that runs the xibecode CLI underneath: Open the app — You see a VS Code-style welcome screen Pick a folder — Open Folder, Clone Repository, or New Project XibeCode starts — The app runs xibecode chat in your chosen folder Full WebUI — The entire XibeCode IDE loads in a native window Since all the AI logic lives in the CLI package, updating the CLI automatically updates the desktop app's capabilities — no need to download a new app version. # Update the CLI to get new features in the desktop app npm update -g xibecode Features Welcome Screen XibeCode branding with gradient ASCII logo Open Folder — Native OS file picker Clone Repository — Git clone dialog New Project — Create and open a new folder Recent Projects — Quick access to previously opened folders with timestamps CLI Status — Shows installed xibecode version IDE Window Once you open a folder, the full XibeCode WebUI loads with: AI Chat panel with streaming responses Monaco code editor with syntax highlighting File explorer with recursive directory tree Git panel with staging, commits, and diffs Integrated terminal with PTY support Environment variables editor Chat history with per-project persistence 13 agent modes including interactive Plan Mode Installation Windows Download the .exe installer from Releases and run it. macOS Download the .dmg file, open it, and drag XibeCode to your Applications folder. macOS Unsigned App Since the app is not signed, you may need to right-click and select "Open" the first time, then click "Open" in the dialog. Linux Debian/Ubuntu (.deb): sudo dpkg -i xibecode-desktop_0.5.0_amd64.deb Fedora/RHEL (.rpm): sudo rpm -i xibecode-desktop-0.5.0.x86_64.rpm AppImage (any distro): chmod +x XibeCode-0.5.0-x86_64.AppImage ./XibeCode-0.5.0-x86_64.AppImage Troubleshooting "xibecode not found" The desktop app requires the CLI to be installed globally: npm install -g xibecode Blank screen after opening folder Make sure the CLI is up to date and the WebUI is built: npm update -g xibecode App doesn't open on macOS Right-click the app and select "Open" to bypass Gatekeeper for unsigned apps. Building from Source git clone https://github.com/iotserver24/xibecode cd xibecode/electron npm install npm run build:ts npm run dev On this page Download Prerequisites How It Works Features Welcome Screen IDE Window Installation Windows macOS Linux Troubleshooting "xibecode not found" Blank screen after opening folder App doesn't open on macOS Building from Source Ctrl+I Assistant How can I help? Ask me about configuration, installation, or specific features. ---