# Pomera AI Commander
> Pomera AI Commander is a comprehensive text processing toolkit with 24+ MCP (Model Context Protocol) tools for AI assistants. It provides persistent notes, web search, semantic diff/merge, AI delegation, regex find & replace, HTML processing, config validation, and more.
Important notes:
- Pomera can run as a standalone GUI application OR as an MCP server for AI integration
- All 24+ tools are available via MCP protocol for use with Cursor, Claude Desktop, VS Code, Antigravity, Cline, etc.
- Written in Python with cross-platform support (Windows, Linux, macOS)
- Works 100% offline by default — optional API keys unlock web search and AI features
## Top 10 Critical Tools for Agentic AI
1. `pomera_notes` - Persistent memory with FTS5 search (prevents re-pasting, ~100K+ token savings)
2. `pomera_web_search` - 7-engine web search (Tavily/Exa/Brave/Google/DuckDuckGo/SerpAPI/Serper)
3. `pomera_read_url` - Fetch & convert HTML to clean markdown
4. `pomera_find_replace_diff` - Regex with diff preview & auto-backup to notes
5. `pomera_smart_diff_2way` - Semantic config diff (JSON/YAML/ENV/TOML, ignores formatting)
6. `pomera_smart_diff_3way` - 3-way merge with conflict resolution (auto-merge + report)
7. `pomera_ai_tools` - Multi-provider AI delegation (11 providers, research, deep reasoning)
8. `pomera_json_xml` - Validate/prettify/minify/convert JSON↔XML configs
9. `pomera_extract` - Extract emails/URLs/regex patterns from large text
10. `pomera_html` - HTML content extraction (visible text, links, images, tables, forms)
## All Available MCP Tools
### Critical Efficiency Tools
- `pomera_notes`: Persistent notes database (save, get, search, list, update, delete) with FTS5 full-text search, encryption, dual input/output fields
- `pomera_web_search`: Multi-engine web search (Tavily AI-optimized, Exa neural, Brave, Google, DuckDuckGo, SerpAPI, Serper) with result counts and file output
- `pomera_read_url`: Fetch URL content, convert HTML to markdown with main content extraction
- `pomera_find_replace_diff`: Regex find/replace with validate → preview → execute workflow, automatic backup to notes
- `pomera_smart_diff_2way`: Semantic diff for structured data (JSON/JSON5/YAML/ENV/TOML), format-aware comparison ignoring whitespace, auto-repair LLM JSON output, schema validation
- `pomera_smart_diff_3way`: 3-way merge for structured data, auto-resolve non-conflicting changes, conflict strategies (report/keep_yours/keep_theirs), git merge assistance
- `pomera_ai_tools`: Access 11 AI providers (OpenAI, Anthropic, Google AI, Groq, OpenRouter, Azure, Vertex AI, Cohere, HuggingFace, LM Studio, AWS Bedrock), actions: generate, research (web + reasoning), deep reasoning (6-step protocol)
- `pomera_json_xml`: Format, validate, minify, convert between JSON and XML
- `pomera_extract`: Extract content from text (type: regex, emails, urls) with dedup/sort
- `pomera_html`: Process HTML content — extract visible text, clean HTML, extract links/images/headings/tables/forms
### High-Value Support Tools
- `pomera_generators`: Generate passwords, UUIDs, lorem ipsum, random emails, URL slugs
- `pomera_text_stats`: Count characters, words, lines, paragraphs, reading time, top words
- `pomera_markdown`: Strip markdown, extract links/headers, table conversion
- `pomera_line_tools`: Add/remove line numbers, deduplicate, remove empty, reverse, shuffle
- `pomera_list_comparator`: Compare two lists, find unique/common/missing items
### Text Transform Tools
- `pomera_case_transform`: Transform text case (sentence, lower, upper, title, alternating, inverse)
- `pomera_whitespace`: Normalize whitespace, tabs/spaces conversion, line ending normalization
- `pomera_sort`: Sort lines alphabetically, numerically, by length, randomize
### Encoding Tools
- `pomera_encode`: Encoding operations (type: base64, hash, number_base)
- `pomera_string_escape`: Escape/unescape HTML, URL, JSON, regex characters
- `pomera_translator`: Translate text to Morse code, binary, NATO alphabet
### Data & Analysis Tools
- `pomera_column_tools`: Extract, reorder, merge CSV/TSV columns
- `pomera_url_parse`: Parse URLs into components (protocol, host, path, query)
- `pomera_timestamp`: Convert between Unix timestamps and human dates
- `pomera_cron`: Parse and explain cron expressions
- `pomera_word_frequency`: Analyze word frequency in text
- `pomera_email_header_analyzer`: Parse and analyze email headers
### Diagnostics
- `pomera_diagnose`: MCP server self-diagnostics (database paths, config, API key status, encryption health)
## Quick Start
### Install via pip
```bash
pip install pomera-ai-commander
```
### Install via npm
```bash
npm install -g pomera-ai-commander
```
### Configure in MCP client (Cursor/Claude Desktop/Cline/Antigravity)
```json
{
"mcpServers": {
"pomera": {
"command": "python",
"args": ["-m", "pomera.mcp_server"]
}
}
}
```
## Common Agentic Workflows
### Research (97% token reduction)
```
1. pomera_web_search "topic" → Tavily/Exa for best results
2. pomera_read_url <best result> → clean markdown
3. pomera_html extract_links → gather all sources
4. pomera_notes save → persist findings
```
### Config Change Verification
```
1. pomera_json_xml validate → check original
2. Edit config
3. pomera_smart_diff_2way → semantic diff before vs after
4. pomera_json_xml validate → verify changes
```
### 3-Way Config Merge
```
1. pomera_smart_diff_3way base=<original> yours=<your changes> theirs=<their changes>
2. Review auto-merged fields + conflicts
3. Re-run with conflict_strategy="keep_yours" or "keep_theirs"
```
### Regex Operations (80% token reduction)
```
1. pomera_find_replace_diff validate → check syntax
2. pomera_find_replace_diff preview → see diff
3. pomera_find_replace_diff execute → apply with backup
```
### AI Delegation
```
1. pomera_ai_tools --action research --provider OpenAI → deep research + web search
2. pomera_ai_tools --action deepreasoning --provider "Anthropic AI" → structured analysis
3. pomera_notes save → persist findings
```
## Documentation
- [Installation Guide](https://github.com/matbanik/Pomera-AI-Commander/blob/main/llms-install.md): Detailed setup for all MCP clients
- [Tools Documentation](https://github.com/matbanik/Pomera-AI-Commander/blob/main/docs/tools/INDEX.md): Comprehensive guide to all tools
- [MCP Server Guide](https://github.com/matbanik/Pomera-AI-Commander/blob/main/docs/MCP_SERVER_GUIDE.md): MCP protocol documentation
- [Troubleshooting](https://github.com/matbanik/Pomera-AI-Commander/blob/main/docs/TROUBLESHOOTING.md): Common issues and solutions
## Optional
- [Build Guide](https://github.com/matbanik/Pomera-AI-Commander/blob/main/BUILD.md): How to build from source
- [Agentic AI Analysis](https://github.com/matbanik/Pomera-AI-Commander/blob/main/docs/pomera-mcp-agentic-ai-analysis.md): Why AI agents need Pomera
