Tools Router (Unified)

Consolidates: cli-router + tools-router + data-router Purpose: All external tool execution (CLI, MCP, databases) Legacy References: ~/.claude/db/skills/routers/cli-router/, ~/.claude/db/skills/routers/data-router/

CLI Tools (Local Binaries)

AI/LLM Agents

Tool	Binary	Purpose
gemini	/opt/homebrew/bin/gemini	Google Gemini CLI (2M context)
codex	~/.local/bin/codex	OpenAI GPT models
amp	~/.amp/bin/amp	Anthropic Claude via MCP

Context Extraction

Tool	Binary	Purpose
research	~/.local/bin/research	Online documentation
pieces	/opt/homebrew/bin/pieces	Local code context, LTM

Data Processing

Tool	Binary	Purpose
qsv	qsv	Fast CSV processing
jq	jq	JSON processing
nu	nu	Nushell data pipelines

Semantic Search

Tool	Binary	Purpose
ck	ck	Semantic code search
ast-grep	ast-grep	AST pattern matching

---

MCP Tools (Lootbox)

Routes tasks to MCP tools via lootbox code-mode for external service integration.

MCP Tool Categories

Knowledge Graph

Tool	Namespace	Purpose
Neo4j	neo4j	Graph database operations
Neo4j Aura	neo4j-aura	Cloud Neo4j
Neo4j Memory	neo4j-memory	Agent memory graph
DeepGraph	deepgraph	Code graph analysis

Research & Search

Tool	Namespace	Purpose
Perplexity	perplexity	AI-powered web search
Brave Search	brave-search	Web search
InfraNodus	relate	Graph-based text analysis
PageIndex	pageindex-local	Web page indexing

Methodology & Reasoning

Tool	Namespace	Purpose
Meta-CC	meta-cc	Methodology capabilities
Distil (AoT)	distil	Atom of Thoughts
Zen	zen	Multi-model reasoning
Gepa	gepa	Gemini planning

Solvers

Tool	Namespace	Purpose
Z3	solver-z3	SMT solving
MiniZinc	solver-minizinc	Constraint optimization
PySAT	solver-pysat	SAT solving
MaxSAT	solver-maxsat	Maximum satisfiability
ASP	solver-asp	Answer set programming

Storage & Memory

Tool	Namespace	Purpose
Filesystem	filesystem	File operations
MCP Memory	mcp-memory	Key-value memory
Obsidian Memory	obsidian-memory	Obsidian integration
TurboVault	turbovault	High-performance vault

External Services

Tool	Namespace	Purpose
GitHub	github	GitHub API
Zotero	zotero	Citation management
Gemini	gemini	Gemini model access

Lootbox Code-Mode

Configuration

server: ws://localhost:9742/ws
ui: http://localhost:9742/ui
config: ~/lootbox.config.json

Local Tools (Always Available)

tools.kv.*       // Key-value store
tools.sqlite.*   // SQLite database
tools.memory.*   // In-memory storage
tools.graphql.*  // GraphQL queries

Invocation Patterns

# List available tools
lootbox tools

# Execute single operation
lootbox exec 'await tools.neo4j.query({ cypher: "MATCH (n) RETURN n LIMIT 5" })'

# Chain operations
lootbox exec '
  const results = await tools.perplexity.search({ query: "Claude Code best practices" });
  await tools.kv.set({ key: "research", value: results });
  return results;
'

# Parallel operations
lootbox exec '
  const [a, b] = await Promise.all([
    tools.neo4j.query({ cypher: "MATCH (n:Skill) RETURN n" }),
    tools.deepgraph.semantic_search({ query: "authentication" })
  ]);
  return { skills: a, code: b };
'

Routing Logic

MCP Task Detected
    │
    ├── Graph operations?
    │   ├── Neo4j? → tools.neo4j
    │   ├── Code graph? → tools.deepgraph
    │   └── Text graph? → tools.relate
    │
    ├── Research?
    │   ├── AI search? → tools.perplexity
    │   ├── Web search? → tools.brave-search
    │   └── Page index? → tools.pageindex-local
    │
    ├── Reasoning?
    │   ├── Methodology? → tools.meta-cc
    │   ├── Multi-model? → tools.zen
    │   └── AoT? → tools.distil
    │
    ├── Constraint solving?
    │   ├── SMT? → tools.solver-z3
    │   ├── Optimization? → tools.solver-minizinc
    │   └── SAT? → tools.solver-pysat
    │
    └── Storage?
        ├── Files? → tools.filesystem
        ├── KV? → tools.kv
        └── Memory? → tools.memory

Tool Selection Matrix

Task Type	Primary Tool	Alternative
Graph query	neo4j	deepgraph
Web research	perplexity	brave-search
Code analysis	deepgraph	relate
Constraint solving	solver-z3	solver-minizinc
File operations	filesystem	turbovault
Citation	zotero	-
Methodology	meta-cc	distil

Integration

• lootbox: Code-mode execution
• MCP servers: External tool providers
• cli-index: CLI tool fallback
• meta-router: Parent routing

Quick Reference

# Start lootbox server
lootbox server --port 9742

# Check available namespaces
lootbox tools

# Neo4j query
lootbox exec 'await tools.neo4j.query({ cypher: "..." })'

# Perplexity search
lootbox exec 'await tools.perplexity.search({ query: "..." })'

# Chained operations
lootbox exec '
  const data = await tools.X.fetch();
  return tools.Y.process(data);
'