ReyNeill Kontxt

WHAT IT CONNECTS

What ReyNeill Kontxt gives an AI Agent

• Connects to a user-specified local code repository.
• Provides the (`get_codebase_context`) tool for AI clients (like Cursor, Claude Desktop).
• Uses Gemini 2.0 Flash's 1M input window internally to analyze the codebase and generate context based on the user's client querry.
• Flash itself can use internal tools (`list_repository_structure`, `read_files`, `grep_codebase`) to understand the code.
• Supports both SSE (recommended) and stdio transport protocols.
• Supports user-attached files/docs/context from client's queries for more targeted analysis.
• Tracks token usage and provides detailed analysis of API consumption.
• User-configurable token limit for context generation (options: 500k, 800k, or 1M tokens; default: 800k).
• **Clone/Download:** Get the server code.
• **Create Environment:**
• **Install Dependencies:**
• **Install `tree`:** Ensure the `tree` command is available on your system.
• macOS: `brew install tree`
• Debian/Ubuntu: `sudo apt update && sudo apt install tree`
• Windows: Requires installing a port or using WSL.
• **Configure API Key:**
• Copy `.env.example` to `.env`.
• Edit `.env` and add your Google Gemini API Key:
• Alternatively, you can provide the key via the `--gemini-api-key` command-line argument.
• Start the server independently
• Connect from multiple clients
• Keep it running while restarting clients
• `--repo-path PATH`: **Required**. Absolute path to the local code repository to analyze.
• `--gemini-api-key KEY`: Google Gemini API Key (overrides `.env` if provided).
• `--token-threshold NUM`: Target maximum token count for the context. Allowed values are:
• 500000
• 800000 (default)
• 1000000
• `--gemini-model NAME`: Specific Gemini model to use (default: 'gemini-2.0-flash').
• `--transport {stdio,sse}`: Transport protocol to use (default: sse).
• `--host HOST`: Host address for the SSE server (default: 127.0.0.1).
• `--port PORT`: Port for the SSE server (default: 8080).
• "What's this codebase about"
• "How does the authentication system work?"
• "Explain the data flow in the application"
• "Explain how this file works: @kontxt_server.py"
• "Find all files that interact with @user_model.py"
• "Compare the implementation of @file1.js and @file2.js"
• Repository structure listing
• File reading
• Grep searches
• Attached files from user queries
• Generated responses