tachibot-mcp 2.0.2

package/.env.example

@@ -0,0 +1,260 @@
+# TachiBot MCP v2.0 - Configuration
+# Copy this file to .env and add your API keys
+
+# ===================================
+# Profile Selection
+# ===================================
+# Choose your tool profile (controls which tools are loaded)
+# Options: minimal, research_power, code_focus, balanced, full
+# Default: balanced (if not specified)
+# See TOOL_PROFILES.md for details
+TACHIBOT_PROFILE=balanced
+
+# ===================================
+# Required API Keys
+# ===================================
+# Get your API keys from:
+# - Perplexity: https://www.perplexity.ai/settings/api
+# - Grok/xAI: https://console.x.ai/
+# - OpenAI: https://platform.openai.com/api-keys
+# - Google Gemini: https://aistudio.google.com/apikey
+
+# Perplexity API (for web search, research, reasoning)
+PERPLEXITY_API_KEY=
+
+# Grok API (for code analysis, debugging, architecture)
+GROK_API_KEY=
+
+# OpenAI API (for GPT-5, analysis, comparison)
+OPENAI_API_KEY=
+
+# ===================================
+# Optional API Keys
+# ===================================
+# Google Gemini API (for brainstorming, code/text analysis)
+GOOGLE_API_KEY=
+
+# OpenRouter API (for Qwen3 Coder and other models)
+OPENROUTER_API_KEY=
+
+
+# Anthropic API (optional - not currently used in Claude Code mode)
+# ANTHROPIC_API_KEY=
+
+# Qwen API (for Qwen Max model)
+QWEN_API_KEY=
+
+# ===================================
+# Memory System (Optional)
+# ===================================
+# Supabase configuration for persistent memory storage
+SUPABASE_URL=
+SUPABASE_SERVICE_KEY=
+
+# ===================================
+# Performance Settings
+# ===================================
+# Note: TachiBot does not track API costs internally
+# Monitor your usage through each provider's dashboard
+
+# ===================================
+# Timeout Configuration
+# ===================================
+# IMPORTANT: Adjust these if you experience timeout errors
+# Multi-model operations (verifier, challenger) can take 60-180s
+# Complex workflows can take 5-10 minutes
+
+# Global default timeout for all operations (milliseconds)
+# Default: 90000 (90 seconds)
+TACHI_DEFAULT_TIMEOUT=90000
+
+# Per-tool timeout overrides (milliseconds)
+# Verifier: Multi-model parallel verification (default: 120000 = 2 min)
+TACHI_VERIFIER_TIMEOUT=120000
+
+# Challenger: Critical analysis with fact-checking (default: 180000 = 3 min)
+TACHI_CHALLENGER_TIMEOUT=180000
+
+# Scout: Information gathering with live search (default: 180000 = 3 min)
+TACHI_SCOUT_TIMEOUT=180000
+
+# Focus: Deep reasoning and collaborative sessions (default: 300000 = 5 min)
+TACHI_FOCUS_TIMEOUT=300000
+
+# Workflow: Complex multi-step workflows (default: 300000 = 5 min)
+TACHI_WORKFLOW_TIMEOUT=300000
+
+# PingPong: Multi-round conversations (default: 600000 = 10 min)
+TACHI_PINGPONG_TIMEOUT=600000
+
+# Individual API call timeout (default: 60000 = 1 min)
+# This is PER API call, not total operation time
+TACHI_API_TIMEOUT=60000
+
+# Show progress for operations exceeding this duration (default: 30000 = 30s)
+TACHI_PROGRESS_THRESHOLD=30000
+
+# ===================================
+# Workflow Configuration
+# ===================================
+# Max ping-pong brainstorm rounds (default: 24)
+# Higher values = deeper reasoning but more cost
+MAX_PINGPONG_ROUNDS=24
+
+# Max reasoning rounds for collaborative sessions (1-10)
+MAX_REASONING_ROUNDS=5
+
+# ===================================
+# Search & Research Configuration
+# ===================================
+# Default search provider for scout/research (perplexity, grok, both)
+DEFAULT_SEARCH_PROVIDER=perplexity
+
+# Enable Grok-4 live search in scout mode (costs extra per 1k sources)
+ENABLE_GROK_LIVE_SEARCH=false
+
+# Max sources for Grok live search (default: 100, lower = cheaper)
+GROK_SEARCH_SOURCES_LIMIT=100
+
+# ===================================
+# Optional Settings
+# ===================================
+# Enable visual ASCII art in output
+ENABLE_VISUALS=true
+
+# Enable debug logging
+DEBUG=false
+
+# Default technical domain for brainstorming
+# Options: architecture, algorithms, debugging, security,
+#          performance, api_design, database, frontend,
+#          backend, devops, testing
+DEFAULT_DOMAIN=
+
+# ============================================================================
+# OUTPUT DIRECTORY CONFIGURATION
+# ============================================================================
+# All workflow and session outputs go to workflow-output/ by default
+# Override these to customize output locations
+
+# Base directory for all workflow outputs (workflows/*.yaml execution results)
+# Default: ./workflow-output
+# WORKFLOW_OUTPUT_DIR=./workflow-output
+
+# Directory for session logs (focus/pingpong tool outputs)
+# Default: ./workflow-output/sessions
+# SESSION_OUTPUT_DIR=./workflow-output/sessions
+
+# ============================================================================
+# SESSION CONFIGURATION
+# ============================================================================
+# Controls session logging behavior for focus and pingpong tools
+
+# Enable session logging (saves markdown/json/html logs)
+# Default: true
+# ENABLE_SESSION_LOGGING=true
+
+# Automatically save sessions after completion
+# Default: false
+# SESSION_AUTO_SAVE=false
+
+# Show verbose output during session execution
+# Default: false
+# SESSION_DEFAULT_VERBOSE=false
+
+# Output format for session logs
+# Options: markdown, json, html
+# Default: markdown
+# SESSION_DEFAULT_FORMAT=markdown
+
+# Include metadata (tokens, timing, models) in session logs
+# Default: true
+# SESSION_INCLUDE_METADATA=true
+
+# Maximum number of session history entries to keep
+# Default: 100
+# SESSION_MAX_HISTORY=100
+
+# ===================================
+# Local Model Configuration (Optional)
+# ===================================
+# Configure local model endpoints if you run your own models
+
+# LMStudio endpoint
+LMSTUDIO_BASE_URL=
+
+# Ollama endpoint
+OLLAMA_BASE_URL=
+
+# ===================================
+# Advanced: Model-Specific Overrides
+# ===================================
+# Only change these if you need fine-grained control
+
+# Enable GPT-5 models (requires OpenAI API key)
+ENABLE_GPT5=false
+
+# Enable competitive Qwen mode (enables multi-model parallel reasoning)
+ENABLE_QWEN_COMPETITIVE=false
+
+# Enable expensive models (currently only grok_heavy - 256k context)
+ENABLE_EXPENSIVE_MODELS=false
+
+# Grok Configuration
+ENABLE_GROK_HEAVY=false
+GROK_MAX_TOKENS=100000
+GROK_COST_LIMIT=1.0
+
+# Model priority (lower = higher priority)
+GROK_PRIORITY=2
+
+# ===================================
+# Advanced: Tool-Specific Overrides
+# ===================================
+# Force enable/disable specific tools regardless of profile
+# Example: ENABLE_TOOL_PINGPONG=true
+# Example: DISABLE_TOOL_GROK_SEARCH=false
+
+# ===================================
+# Model Selection (Multi-Model Tools)
+# ===================================
+# Configure which models are used for Scout, Challenger, and Verifier
+# These tools run multiple models in parallel for consensus/verification
+# Comma-separated list of model names (no spaces)
+
+# Scout model configuration
+# quick_scout: Fast checks, cost-efficient (default: qwen/qwen3-coder-plus,gemini-2.5-flash,gpt-5-mini)
+SCOUT_QUICK_MODELS=qwen/qwen3-coder-plus,gemini-2.5-flash,gpt-5-mini
+
+# research_scout: Thorough research (default: qwen/qwen3-coder-plus,gemini-2.5-pro,gpt-5-mini)
+SCOUT_RESEARCH_MODELS=qwen/qwen3-coder-plus,gemini-2.5-pro,gpt-5-mini
+
+# Challenger model configuration
+# Used for critical analysis and counter-arguments (default: qwen/qwen3-coder-plus,gemini-2.5-pro,gpt-5-mini)
+CHALLENGER_MODELS=qwen/qwen3-coder-plus,gemini-2.5-pro,gpt-5-mini
+
+# Verifier model configuration
+# quick_verify: Fast verification (default: qwen/qwen3-coder-plus,gemini-2.5-flash,gpt-5-mini)
+VERIFIER_QUICK_MODELS=qwen/qwen3-coder-plus,gemini-2.5-flash,gpt-5-mini
+
+# standard modes (fact_check, code_verify, security_verify): Balance quality & cost (default: qwen/qwen3-coder-plus,gemini-2.5-pro,gpt-5-mini)
+VERIFIER_STANDARD_MODELS=qwen/qwen3-coder-plus,gemini-2.5-pro,gpt-5-mini
+
+# deep_verify: Maximum quality for critical verification (default: qwen/qwen3-coder-plus,gemini-2.5-pro,gpt-5)
+VERIFIER_DEEP_MODELS=qwen/qwen3-coder-plus,gemini-2.5-pro,gpt-5
+
+# Default models for fallback (default: qwen/qwen3-coder-plus,gemini-2.5-pro,gpt-5-mini)
+DEFAULT_MODELS=qwen/qwen3-coder-plus,gemini-2.5-pro,gpt-5-mini
+
+# ===================================
+# Model Selection Tips
+# ===================================
+# gpt-5-mini vs gpt-5:
+# - gpt-5-mini: Faster, good for most tasks
+# - gpt-5: Full quality, best for critical decisions
+#
+# gemini-2.5-flash vs gemini-2.5-pro:
+# - flash: Faster, good for quick checks
+# - pro: Better reasoning, accuracy, recommended for verification tasks
+#
+# Recommendation: Use defaults (gpt-5-mini + flash) for speed and lower costs.

package/CHANGELOG.md

@@ -0,0 +1,54 @@
+# Changelog
+
+All notable changes to TachiBot MCP will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [2.0.0] - 2025-10-15
+
+### Added
+- Complete rewrite with 12 essential tools (reduced from 80+)
+- Multi-model orchestration with GPT-5, Gemini, Grok, and more
+- Tool profiles system (minimal, research_power, code_focus, balanced, full)
+- Perplexity integration for web search and reasoning
+- Grok-4 integration with live search capabilities
+- Workflow system for multi-step tool sequences
+- Challenger tool for critical thinking and verification
+- Scout tool for hybrid intelligence gathering
+- Verifier tool for multi-model consensus
+- PingPong collaborative brainstorming
+- Cost optimization and tracking features
+- Session management with logging and export
+- Comprehensive .env.example with all configuration options
+- GitHub Actions workflows for CI/CD
+- Community health files (CONTRIBUTING, CODE_OF_CONDUCT, SECURITY)
+
+### Changed
+- Simplified from 80+ tools to 12 essential ones
+- Improved token efficiency (2.6k tokens vs 30k+)
+- Better environment variable handling
+- Deferred API key loading for better performance
+- Modular architecture for easier maintenance
+- Cleaned up workflows to use only existing tools
+
+### Fixed
+- Environment variable loading in MCP context
+- API key configuration issues
+- Build errors with missing personality module
+
+### Security
+- No hardcoded API keys in source code
+- All sensitive data in environment variables
+- Security policy and responsible disclosure process
+
+## [1.0.0] - 2024-12-01
+
+### Initial Release
+- Original version with 80+ tools
+- Basic multi-model support
+- Initial MCP server implementation
+
+---
+
+Note: This is a side project maintained in spare time. Updates may be irregular.

package/CODE_OF_CONDUCT.md

@@ -0,0 +1,56 @@
+# Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our
+community a harassment-free experience for everyone, regardless of age, body
+size, visible or invisible disability, ethnicity, sex characteristics, gender
+identity and expression, level of experience, education, socio-economic status,
+nationality, personal appearance, race, religion, or sexual identity
+and orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment:
+
+* Using welcoming and inclusive language
+* Being respectful of differing viewpoints and experiences
+* Gracefully accepting constructive criticism
+* Focusing on what is best for the community
+* Showing empathy towards other community members
+
+Examples of unacceptable behavior:
+
+* The use of sexualized language or imagery and unwelcome sexual attention or advances
+* Trolling, insulting/derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information without explicit permission
+* Other conduct which could reasonably be considered inappropriate in a professional setting
+
+## Enforcement Responsibilities
+
+Community leaders are responsible for clarifying and enforcing our standards of
+acceptable behavior and will take appropriate and fair corrective action in
+response to any behavior that they deem inappropriate, threatening, offensive,
+or harmful.
+
+## Scope
+
+This Code of Conduct applies within all community spaces, and also applies when
+an individual is officially representing the community in public spaces.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported to the community leaders responsible for enforcement at the repository
+issues section.
+
+All complaints will be reviewed and investigated promptly and fairly.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+version 2.0, available at
+https://www.contributor-covenant.org/version/2/0/code_of_conduct.html.
+
+[homepage]: https://www.contributor-covenant.org

package/CONTRIBUTING.md

@@ -0,0 +1,54 @@
+# Contributing to TachiBot MCP
+
+Thank you for your interest in contributing!
+
+## Getting Started
+
+1. Fork the repository
+2. Create a feature branch (`git checkout -b feature/amazing-feature`)
+3. Make your changes
+4. Run tests (`npm test`)
+5. Build (`npm run build`)
+6. Commit your changes (`git commit -m 'Add amazing feature'`)
+7. Push to your fork (`git push origin feature/amazing-feature`)
+8. Open a Pull Request
+
+## Development Setup
+
+```bash
+git clone https://github.com/pavveu/tachibot-mcp.git
+cd tachibot-mcp
+npm install
+cp .env.example .env  # Add your API keys
+npm run build
+npm test
+```
+
+## Guidelines
+
+- Write clear commit messages
+- Add tests for new features
+- Update documentation
+- Follow existing code style
+- One feature per PR
+
+## Reporting Issues
+
+Use the issue templates and include:
+- TachiBot version
+- Node version
+- Operating system
+- Steps to reproduce
+- Error messages
+
+## Questions?
+
+- Email: `tachibotmcp [at] gmail [dot] com`
+- Open a [Discussion](https://github.com/pavveu/tachibot-mcp/discussions)
+- Create an issue
+
+## License
+
+By submitting code to this project, you agree that your contributions will be licensed under the AGPL-3.0 license and you grant Pawel Pawlowski the right to relicense your contributions under alternative licenses (including commercial licenses).
+
+See [CLA.md](./CLA.md) for full terms.

package/Dockerfile

@@ -0,0 +1,36 @@
+FROM node:18-alpine AS builder
+WORKDIR /app
+
+# Copy package files
+COPY package*.json tsconfig.json ./
+
+# Install dependencies with caching
+RUN --mount=type=cache,target=/root/.npm npm install
+
+# Copy source code
+COPY . .
+
+# Build the application
+RUN npm run build
+
+FROM node:18-alpine AS release
+WORKDIR /app
+
+# Copy only the necessary files from builder
+COPY --from=builder /app/dist /app/dist
+COPY --from=builder /app/package*.json ./
+
+# Set production environment
+ENV NODE_ENV=production
+
+# Install only production dependencies
+RUN npm ci --ignore-scripts --omit=dev
+
+# Set executable permissions
+RUN chmod +x dist/server.js
+
+# Set the user to non-root
+USER node
+
+# Use ENTRYPOINT instead of CMD for better compatibility
+ENTRYPOINT ["node", "dist/server.js"]