NEEITH CLI Agent

NEEITH is an AI-powered CLI agent for development tasks, featuring file operations, semantic code search, and AI assistance.

Features

• 🤖 AI-Powered Development - Intelligent code generation and file operations
• 🔍 Semantic Search - Find relevant code using natural language queries
• 📁 File Operations - Read, write, delete, and search files
• 🎨 Code Formatting - Automatic code formatting with Prettier
• 🌐 MCP Server - Model Context Protocol support for AI integrations

Installation

//Install neeith globally

npm i neeith -g 

//Install neeith locally

npm i neeith

Usage

Interactive REPL Mode

npx neeith

Start an interactive session to chat with the AI agent.

Index Your Project

npx neeith index [directory]

Build a vector index of your project for semantic search capabilities.

MCP Server Mode

npx neeith mcp

Start the Model Context Protocol server for integration with MCP clients like Claude Desktop.

See MCP_SERVER.md for detailed MCP server documentation.

MCP Integration

NEEITH can be integrated with MCP-compatible clients:

Claude Desktop Configuration:

Add this to your claude_desktop_config.json: (Windows: %APPDATA%\Claude\claude_desktop_config.json) (Mac: ~/Library/Application Support/Claude/claude_desktop_config.json)

{
  "mcpServers": {
    "neeith": {
      "command": "npx",
      "args": ["-y", "neeith", "mcp"]
    }
  }
}

Available Tools (via MCP)

• read_file - Read file contents
• write_file - Create or update files
• delete_file - Remove files
• list_files - List directory contents
• find_files - Search for files by pattern
• format_file - Format code with Prettier
• get_ast_preview - Get AST or text preview
• semantic_search - Search codebase semantically
• get_cwd - Get current directory info
• test_write - Test file write capabilities

Configuration

Create a .env file with your API key:

OPENROUTER_API_KEY=your_api_key_here

Documentation

• MCP Server Guide - Complete MCP server documentation
• Debug File Writes - File operation debugging
• Terminal File Operations - Terminal integration details
• Robustness Improvements - System improvements

Requirements

• Node.js 18.x or higher
• npm or yarn

Contributing

GITHUB

https://github.com/maxsunil/cli-agent.git

License

MIT

Keywords

• NEEITH
• AI Agent
• MCP
• Claude Desktop
• Claude
• CLI Agent