Skip to content

TOOLING.md

Latest commit

 

History

History
72 lines (59 loc) · 5.71 KB

TOOLING.md

File metadata and controls

72 lines (59 loc) · 5.71 KB
Raw

Tooling and MCP Catalog

This repository is designed around the idea that agents should use the right tool for the job. The model should not guess when a search engine, code graph, browser scraper, repository ingester, documentation fetcher, or local data explorer can provide better context.

OpenCode plugins

Plugin Purpose
@opencode-ai/plugin Base OpenCode plugin layer.
@macrodata/opencode Macrodata integration for persistent memory and continuity.

MCP servers from opencode.json

MCP Type Default Purpose
puppeteer local disabled Browser automation through the Model Context Protocol. Useful when an agent needs rendered pages, browser flows, screenshots, or JS-heavy websites. Disabled by default in this template.
memory local disabled Reference MCP memory server for local memory experiments. Disabled by default because Macrodata is the primary persistent memory layer.
gitnexus local enabled Code intelligence MCP. Builds and queries a graph of the repository so agents can inspect symbols, dependencies, call chains, impact radius, and safe refactoring paths.
exa remote enabled Remote research MCP for web search, advanced search, code-context lookup, crawling, company/person research, and long-running deep research workflows.
brave-search local enabled Search MCP backed by Brave Search. Good for recent public web results and a second opinion next to Exa.
fetcher local enabled Single-page fetcher for quickly pulling web pages, documentation, or raw markdown into context.
reddit local enabled Reddit MCP for community research, product opinions, debugging anecdotes, and sentiment checks.
youtube-transcript local enabled Transcript extraction for YouTube videos, useful for turning talks, demos, tutorials, and product announcements into agent-readable text.
youtube-data local enabled YouTube Data API integration for metadata, channel/video lookup, and richer YouTube research workflows.
time local enabled Time and timezone MCP used when tasks depend on local time, schedules, or date-sensitive planning.
context7 local enabled Documentation MCP for fetching current library/framework docs directly into the agent context.
desktop-commander local enabled Local desktop/file-system automation MCP. Powerful and intentionally gated behind ask permissions in this config.
github local enabled GitHub MCP for repository exploration, issues, pull requests, files, and source context from GitHub.
gitingest local enabled Repository ingestion MCP that converts repositories into LLM-friendly summaries/context for analysis.
data-explorer local enabled Local data and file exploration MCP for inspecting workspace structure, datasets, and tabular assets.
kaggle local disabled Kaggle MCP for dataset and notebook workflows. Disabled by default because it needs user-specific credentials.
google-maps local disabled Google Maps MCP for geospatial and place research. Disabled by default because it needs an API key and is not needed for most coding tasks.
simple-arxiv local disabled Lightweight arXiv research MCP for papers and academic discovery. Disabled by default in this template.
mcp-compass local enabled MCP discovery and navigation helper. Useful for understanding what MCP tools are available and how to route tasks to them.

Shell tools allowed by the config

Tool Purpose
git Version control and branch workflow.
npm Node.js package scripts and package management.
bun Fast JS runtime/package runner used by selected MCP tools and modern web projects.
python3 Python execution for scripts, data utilities, automation, and Python projects.
ls / cat Basic project inspection and temporary markdown/document reading.
crwl / Crawl4AI Browser-backed scraping pipeline that renders JS, bypasses noisy UI, and produces clean Markdown or JSON for agents.
npx gitnexus CLI fallback for GitNexus analysis, graph queries, impact analysis, and safe refactoring when MCP calls fail.

Skill namespaces allowed by the config

Namespace Purpose
agent-* Agent workflow skills for planning, review, TDD, docs, and build loops.
macrodata-* Macrodata onboarding, dreamtime, distillation, and memory maintenance.
gitnexus-* GitNexus analysis, debugging, impact analysis, refactoring, and CLI workflows.
ultraskill-* Project standards and high-quality engineering workflows.

How the tools are intended to work together

  • GitNexus handles repository intelligence: graph, impact, relationships, and safe changes.
  • Macrodata handles continuity: memory, journals, project state, and next-session context.
  • Crawl4AI / crwl handles rendered website scraping and clean markdown extraction.
  • Exa and Brave Search handle web research and recent information.
  • Context7 and Fetcher handle documentation and page-level context.
  • GitHub and Gitingest handle external repositories and source analysis.
  • MCP Compass helps discover and reason about available MCP capabilities.
  • Data Explorer handles local data/file exploration.
  • YouTube and Reddit MCPs turn community/video sources into usable research material.
  • Desktop Commander can automate local machine interactions, but should stay gated behind approval.

Temporary context files

A recurring pattern in this config is to let the agent create temporary markdown or JSON files from raw pages, inspect them, distill them into memory or the current answer, and then delete them. This keeps the working context grounded without polluting the project.