Tenets

Local MCP server delivering intelligent code context and analysis for AI coding workflows.

Overview

• Tenets is a development intelligence platform for AI-assisted coding workflows.
• It operates as a Model Context Protocol (MCP) server, Python library, and command-line interface.
• Utilizes natural language processing and structured code analysis for codebase enhancement.
• Employs ranking algorithms (BM25, TF-IDF) and import graph analysis to prioritize relevant files.
• Integrates with AI coding assistants via native MCP support for optimized context delivery.
• Processes runs locally, ensuring code privacy without reliance on external cloud APIs.
• Features tools for code quality evaluation, development insights, and session management.
• Allows developers to define guiding principles ("tenets") for AI interactions.
• Tracks project health through metrics like complexity and technical debt.
• Visualizes architecture with dependency graphs to improve development productivity and decision-making.

Features

Local MCP server providing direct integration with AI coding assistants
NLP-powered ranking using BM25, TF-IDF, and import graph analysis
Fully local processing ensuring privacy and eliminating cloud dependencies
Intelligent context building with semantic and structural code analysis
Stateful sessions that maintain persistent context across prompts
Guiding tenets system to enforce consistent development principles
Comprehensive code quality analysis including complexity and maintainability metrics
Token optimization and summarization tailored to model constraints
Development intelligence tools such as velocity tracking and hotspot analysis
Visualization capabilities including interactive dependency graphs

FAQ

  1. What is Tenets used for?

    Tenets helps developers supply optimized code context to AI assistants by automatically ranking and summarizing relevant files based on natural language queries and code structure.

  2. Does Tenets require cloud services?

    No. Core functionality runs entirely locally, meaning code remains private and external APIs are not required unless optional integrations are enabled.

  3. How does Tenets find relevant code?

    It combines NLP techniques like BM25 and TF-IDF with structural analysis, import relationships, and optional semantic embeddings to rank files.

  4. Which tools or environments can it integrate with?

    Tenets supports native MCP integration with compatible AI development tools such as Cursor, Claude Desktop, and Windsurf.

  5. What are tenets within the platform?

    Tenets are persistent guiding principles defined by the user that influence how context is built and how AI assistants interpret project requirements.