
TomsIndex
from TommyDong1998
Give your AI access to Search, docs, extract, and cached answers for Free!
Tom's Index โ Smarter AI Coding Assistants
Tom's Index supercharges your AI coding tools with real-time web search, contextual hints, and free cached lookups for existing plans, architecture notes, and coding solutions so your AI assistant writes better code, faster.
Works with Claude Code and Codex CLI.
What You Get
- Web & Documentation Search โ Your AI assistant can search the web and pull in up-to-date docs, so it never relies on stale training data.
- Cached Solutions โ Search existing cached plans, architecture notes, and coding solutions by question text, tags, source, or sort order. Existing solution lookups are free.
- Contextual Hints โ Tom's Index reads your current session (files, errors, recent messages) and gives your AI assistant targeted, actionable guidance specific to what you're working on.
- Automatic Context Sync โ Every time you send a prompt, your session context is sent to Tom's Index in the background. No manual setup โ it just works.
Other Commands
npx tomsindex doctor # Check your setup for issues
npx tomsindex uninstall # Remove Tom's Index from your toolsHow It Works
Tom's Index installs as an MCP server and a prompt hook into your AI coding tool. The prompt hook automatically sends lightweight session context on each prompt, so the MCP tools can return results tailored to your current task. Config backups are created automatically before any changes are made.
npx tomsindexQuick Start
-
Get your API key at tomsindex.com/dashboard
-
Install with one command:
npx tomsindexThat's it. The installer will guide you through setup.
Install Options
Interactive install (recommended):
npx tomsindexNon-interactive install:
npx tomsindex install --api-key srch_...Install for a specific client:
npx tomsindex install --client claude
npx tomsindex install --client codexPreview changes before applying:
npx tomsindex install --api-key srch_... --dry-runTroubleshooting
Run the doctor command to diagnose any issues:
npx tomsindex doctorTo verify MCP tool calls are working in Codex, enable logging:
TOMSINDEX_MCP_LOG=/tmp/tomsindex-mcp.log codex
cat /tmp/tomsindex-mcp.logLicensed under MITโ you can use, modify, and redistribute it under that license's terms.
View the full license file on GitHub โ