Skip to main content

CLI ↔ MCP Mirror Mapping

Complete mapping between CLI commands (tri <group> <subcommand>) and MCP tools.

Goal: Every CLI command has an MCP mirror. Every MCP tool maps to a CLI command.

Status Legend​

  • ✅ = MCP tool exists and maps to CLI command
  • ❌ = CLI command has no MCP mirror yet
  • 🔲 = MCP-only tool (no CLI equivalent, computed in-process)

Core Commands​

CLI CommandMCP ToolStatus
tri <command>tri_execute✅
tri code <prompt>tri_code✅
tri gen <spec>tri_gen✅
tri spec-create <name>tri_spec_create✅
tri decompose <task>tri_decompose✅
tri plan <task>tri_plan✅
tri verifytri_verify✅
tri bench [suite]tri_bench✅
tri verdicttri_verdict✅
tri test <file>tri_test✅
tri test [pattern]tri_test_run✅
tri fix <file>tri_fix✅
tri explain <target>tri_explain✅
tri refactor <file>tri_refactor✅
tri doc <file>tri_doc✅
tri reason <prompt>tri_reason✅
tri notify <text>tri_notify✅
tri pipeline <task>tri_pipeline✅
tri chat <msg>tri_chat✅

Git Commands​

CLI CommandMCP ToolStatus
tri git statustri_status✅
tri git difftri_diff✅
tri git logtri_log✅
tri git commit <msg>tri_commit✅

Doctor Commands​

CLI CommandMCP ToolStatus
tri doctordoctor_status✅
tri doctor scandoctor_scan✅
tri doctor reportdoctor_report✅
tri doctor plandoctor_plan✅
tri doctor healdoctor_heal✅
tri doctor init—❌
tri doctor enforce—❌
tri doctor enforce-check—❌
tri doctor mark—❌

Job Commands​

CLI CommandMCP ToolStatus
tri job start <cmd>job_start✅
tri job status [id]job_status✅
tri job logs [id]job_logs✅
tri job listjob_list✅
tri job cancel <id>job_cancel✅
tri job artifacts <id>job_artifacts✅

Issue Commands​

CLI CommandMCP ToolStatus
tri issue listissue_list✅
tri issue view <N>issue_view✅
tri issue create <title>issue_create✅
tri issue comment <N> <body>issue_comment✅
tri issue close <N>issue_close✅
tri issue assign <N> <user>issue_assign✅
tri issue decompose <N>issue_decompose✅

Deploy Commands​

CLI CommandMCP ToolStatus
tri deploy statusdeploy_status✅
tri deploy logsdeploy_logs✅
tri deploy varsdeploy_vars✅
tri deploy startdeploy_start✅
tri deploy stopdeploy_stop✅

Experience Commands​

CLI CommandMCP ToolStatus
tri experience save <k> <v>experience_save✅
tri experience recall <k>experience_recall✅
tri experience mistakesexperience_mistakes✅

FPGA Commands​

CLI CommandMCP ToolStatus
tri fpga uart scanfpga_uart_scan✅
tri fpga uart pingfpga_uart_ping✅
tri fpga uart send <hex>fpga_uart_send✅
tri fpga synthfpga_synth✅
tri fpga statusfpga_status✅
tri fpga buildfpga_build✅
tri fpga verifyfpga_verify✅
tri fpga flash <bit>fpga_flash✅

Cloud Commands​

CLI CommandMCP ToolStatus
tri cloud spawn <N>cloud_spawn✅
tri cloud kill <N>cloud_kill✅
tri cloud agentscloud_list✅
tri cloud statuscloud_status✅
tri cloud logscloud_logs✅
tri cloud spawn-allcloud_spawn_all✅
tri cloud cleanupcloud_cleanup✅
tri cloud history [N]cloud_history✅
tri cloud api-checkcloud_api_check✅
tri cloud redeploy <sid> <N>cloud_redeploy✅
tri cloud diagnose <N>cloud_diagnose✅
tri cloud issue-create <t>cloud_issue_create✅
tri cloud farmcloud_farm✅
tri cloud farm synccloud_farm_sync✅
tri cloud farm capacitycloud_farm_capacity✅
tri cloud farm rebalancecloud_farm_rebalance✅
tri cloud train <name>cloud_train✅
tri cloud train-batchcloud_train_batch✅

Farm Commands​

CLI CommandMCP ToolStatus
tri farm statusfarm_status✅
tri farm idlefarm_idle✅
tri farm recyclefarm_recycle✅
tri farm fillfarm_fill✅
tri farm evolve statusfarm_evolve_health✅
tri farm evolve notifyfarm_evolve_notify✅
tri farm evolve watchfarm_evolve_watch✅

Patent Commands​

CLI CommandMCP ToolStatus
tri patent statuspatent_status✅
tri patent analysispatent_analysis✅
tri patent claims—❌
tri patent strategy—❌
tri patent snapshot—❌
tri patent draft—❌
tri patent zenodo—❌

DePIN Commands​

CLI CommandMCP ToolStatus
tri depin statusdepin_status✅
tri depin nodesdepin_nodes✅
tri depin fitnessdepin_fitness✅

Research / Experiment Commands​

CLI CommandMCP ToolStatus
tri research <query>research_query✅
tri experiment listexperiment_list✅
tri experiment compare <a> <b>experiment_compare✅

Chimera Commands​

CLI CommandMCP ToolStatus
tri chimera <name>chimera_run✅

Ouroboros Commands​

CLI CommandMCP ToolStatus
tri ouroboros statusouroboros_status✅
tri ouroboros runouroboros_run✅

Self Commands​

CLI CommandMCP ToolStatus
tri self testself_test✅
tri self healthself_health✅

Context Commands​

CLI CommandMCP ToolStatus
tri context infocontext_info✅
tri context load <path>context_load✅

Faculty / MU Commands​

CLI CommandMCP ToolStatus
tri facultyfaculty_status✅
tri mu statusmu_status✅
tri mu patternsmu_patterns✅

Zenodo Commands​

CLI CommandMCP ToolStatus
tri zenodo statuszenodo_status✅

Utility Commands​

CLI CommandMCP ToolStatus
tri analyzetri_analyze✅
tri cleantri_clean✅
tri fmttri_fmt✅
tri statstri_stats✅
tri linttri_lint✅
tri search <query>tri_search✅
tri metricstri_metrics✅
tri tracetri_trace✅
tri evaltri_eval✅

Chain Commands​

CLI CommandMCP ToolStatus
tri chainchain_list✅
tri chain <link> --task <t>chain_<link>✅ (all 26)

MCP-Only Tools (no CLI equivalent)​

MCP ToolDescription
needle_* (20 tools)AST-aware editing (in-process, no CLI)
swarm_* (14 tools)Agent swarm state machine (in-process)
oracle_* (3 tools)Telegram watchdog (in-process thread)
tri_train_* (5 tools)Training monitor (reads checkpoints directly)
tri_constants/phi/fib/lucasSacred math (computed in-process)
tri_chem_*/bio_*/quantum_*Science tools (computed in-process)
tri_formulaSacred formula evaluator (in-process)

Summary​

CategoryCLI CommandsMCP ToolsCoverage
Core1919100%
Git44100%
Doctor8563%
Job66100%
Issue77100%
Deploy55100%
Experience33100%
FPGA88100%
Cloud1818100%
Farm77100%
Patent7229%
DePIN33100%
Research11100%
Experiment22100%
Chimera11100%
Ouroboros22100%
Self22100%
Context22100%
Faculty/MU33100%
Zenodo11100%
Utility99100%
Chain2727100%
Mapped Total~145~137~94%
MCP-only—~58—
Grand Total~145~195—

Remaining Gaps (❌)​

CLI CommandPriorityNotes
tri doctor initLowCombines scan + mark + report
tri doctor enforceLowSetup instructions only
tri doctor enforce-checkLowHook binary
tri doctor markLowAdd markers to files
tri patent claimsMediumClaims listing
tri patent strategyMediumStrategy overview
tri patent snapshotLowCreate snapshot
tri patent draftMediumDraft generation
tri patent zenodoLowZenodo upload

These can be added via tri_execute universal executor as a fallback.