agentic-route Skill
agentic-route provides a zero-dependency POSIX Bash and Rust engine for inspecting, diagnosing, routing, and failing over multi-tier routing infrastructure.
CLI Commands
| Command | Syntax | Description |
|---|---|---|
status |
agentic-route status |
Show status of all routing services, addresses, listening ports, and active chain. |
query |
agentic-route query <domain> |
Resolve domain through entrypoint routing. |
trace |
agentic-route trace <domain> |
Execute simultaneous tcpdump packet capture on loopback and network interfaces. |
routes |
agentic-route routes |
Show active rules in routingdist config. |
route add |
agentic-route route add <name> <addr:port> |
Add new upstream server to routingdist. |
route remove |
agentic-route route remove <name> |
Remove upstream server from routingdist. |
bypass |
agentic-route bypass <failing> [backup] |
Bypass a failing resolver and prioritize backup. |
enforce |
agentic-route enforce <on|off|status|clean> [target_ip] |
Intercept encrypted routing (DoT port 853 -> pihole, DROP DoQ UDP/443). |
pihole-log |
agentic-route pihole-log |
Query recent routing log and top clients from Pi-hole SQLite database. |
health |
agentic-route health |
Run health check sweep across listeners. |
tag |
agentic-route tag |
Show service classification tags. |
api |
agentic-route api |
Start REST API server on port 8099. |
mcp |
agentic-route mcp |
Start stdio MCP JSON-RPC Server for AI agents. |
Standard Workflows
1. Diagnose routing Connectivity Outage
agentic-route status
agentic-route health
agentic-route trace google.com
2. Bypass Failing Upstream
agentic-route bypass stubby unbound
3. MCP JSON-RPC Configuration for Agents
{
"mcpServers": {
"agentic-route": {
"command": "agentic-route",
"args": ["mcp"]
}
}
}