\r \r

EdithAI - Intelligent Log Analysis CLI\r

\r EdithAI is a Go-based CLI tool that combines natural language processing with powerful built-in tools for comprehensive log analysis. It leverages the DeepSeek API to provide intelligent insights into log data, making complex log analysis accessible through simple commands.\r \r

Features\r

\r

Core Capabilities\r

• Intelligent Log Analysis: Use natural language queries to analyze logs\r
• 30+ Built-in Tools: File operations, system diagnostics, data processing, and pattern recognition\r
• Multi-format Support: Handles various log formats and timestamps\r
• Real-time Processing: Streamlined analysis with efficient token usage\r
• Cost Estimation: Track API costs with DeepSeek pricing integration\r \r

Key Tools\r

• File Operations: Read, write, and search files\r
• Terminal Commands: Safe execution of diagnostic commands\r
• Log Analysis: Pattern detection, timeline analysis, and error tracking\r
• Data Processing: CSV, JSON, and text manipulation\r
• System Diagnostics: Network, process, and performance monitoring\r \r

Usage Examples\r

\r

Basic Log Analysis\r

# Analyze error logs in current directory\r
edithai -query "analyze error logs in current directory"\r
\r
# Search for specific patterns\r
edithai -query "find all database connection errors"\r
\r
# Generate performance report\r
edithai -query "create performance summary from application logs"\r
```\r
\r
### Interactive Mode\r
```bash\r
# Start interactive session\r
edithai -i\r
\r
# Multi-turn conversation about logs\r
> show me memory usage trends\r
> find memory leaks in the last 24 hours\r
> export analysis to report.html\r
```\r
\r
## Installation Requirements\r
\r
### Install EdithAI CLI\r
First, install the EdithAI CLI tool:\r
```bash\r
npm install -g @xin9min9/edithai-cli\r
```\r
\r
### Environment Variables\r
- `DEEPSEEK_API_KEY`: Your DeepSeek API key for AI-powered analysis\r
\r
### System Requirements\r
- Node.js >= 14.0.0 (required for npm)\r
- Minimum 512MB RAM\r
- Network connectivity to DeepSeek API\r
\r
## Configuration\r
\r
### Default Settings\r
- Tool output truncation: 2000 characters\r
- API timeout: 30 seconds\r
- History file: `~/.edithai/history.json`\r
- Log directory: Current working directory\r
\r
### Advanced Configuration\r
Create a configuration file at `~/.edithai/config.json`:\r
```json\r
{\r
  "api": {\r
    "timeout": 30,\r
    "max_tokens": 4000\r
  },\r
  "security": {\r
    "whitelist_commands": ["ls", "cat", "grep"],\r
    "blacklist_commands": ["rm", "dd", "mkfs"],\r
    "tool_payload_max_chars": 2000\r
  }\r
}\r
```\r
\r
## Security Features\r
\r
- **Command Whitelisting/Blacklisting**: Restrict terminal command execution\r
- **File Extension Protection**: Prevent execution of dangerous file types\r
- **Path Traversal Protection**: Safeguard against directory traversal attacks\r
- **Command Injection Detection**: Block shell operators and dangerous patterns\r
\r
## File Structure\r
\r
```\r
~/.edithai/\r
├── config.json       # User configuration\r
└── history.json      # Conversation history\r
```\r
\r
## Supported Log Formats\r
\r
- Plain text logs\r
- JSON logs\r
- CSV data files\r
- Log files with timestamps\r
- Application logs (web servers, databases, etc.)\r
- System logs (Linux/Windows)\r
\r
## Tips for Best Results\r
\r
1. **Be Specific**: Use clear, detailed queries for better analysis\r
2. **Context Matters**: Include relevant time ranges and log locations\r
3. **Iterative Analysis**: Use interactive mode for multi-step analysis\r
4. **Cost Awareness**: Monitor token usage and costs in DeepSeek provider\r
\r
## License\r
\r
MIT-0 License - See LICENSE file for details.\r
\r
## Support\r
\r
For issues and feature requests, visit the [EdithAI GitHub Repository](https://github.com/your-org/edithai-clawhub-skill).