Metadata-Version: 2.4
Name: logthread
Version: 1.0.7
Summary: Log Thread — AI-powered code intelligence with graph context. Enables even smaller AI models to make accurate code changes by providing rich structural understanding of your codebase.
Project-URL: Homepage, https://logthread.dev
Author: Log Thread Team
License: UNLICENSED
Keywords: ai-code-editor,code-context,code-intelligence,knowledge-graph,logthread,mcp,static-analysis,tree-sitter
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: Other/Proprietary License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Code Generators
Classifier: Topic :: Software Development :: Quality Assurance
Requires-Python: >=3.11
Requires-Dist: fastapi>=0.115.0
Requires-Dist: fastembed>=0.7.0
Requires-Dist: igraph>=1.0.0
Requires-Dist: kuzu>=0.11.0
Requires-Dist: leidenalg>=0.11.0
Requires-Dist: mcp>=1.0.0
Requires-Dist: pathspec>=1.0.4
Requires-Dist: rich>=13.0.0
Requires-Dist: sse-starlette>=2.0.0
Requires-Dist: tree-sitter-c-sharp>=0.23.0
Requires-Dist: tree-sitter-go>=0.23.0
Requires-Dist: tree-sitter-java>=0.23.0
Requires-Dist: tree-sitter-javascript>=0.23.0
Requires-Dist: tree-sitter-python>=0.23.0
Requires-Dist: tree-sitter-ruby>=0.23.0
Requires-Dist: tree-sitter-typescript>=0.23.0
Requires-Dist: tree-sitter>=0.25.0
Requires-Dist: typer>=0.15.0
Requires-Dist: uvicorn[standard]>=0.34.0
Requires-Dist: watchfiles>=1.0.0
Provides-Extra: dev
Requires-Dist: pytest-asyncio>=0.24.0; extra == 'dev'
Requires-Dist: pytest-cov>=6.0.0; extra == 'dev'
Requires-Dist: pytest>=8.0.0; extra == 'dev'
Requires-Dist: ruff>=0.9.0; extra == 'dev'
Provides-Extra: neo4j
Requires-Dist: neo4j>=5.0.0; extra == 'neo4j'
Description-Content-Type: text/markdown

<p align="center">
  <img src="logthread-logo.png" alt="Log Thread" width="420" />
</p>

# Log Thread

**Code intelligence that makes AI assistants dramatically more accurate.**

Log Thread analyzes your codebase and provides deep contextual understanding to AI coding assistants, enabling them to write better code with fewer errors and hallucinations.

```
$ logthread analyze .

Analyzing your codebase...
✓ Indexed 142 files
✓ Found 623 symbols and their relationships
✓ Detected 8 architectural modules
✓ Identified 34 execution flows

Done in 4.2s
```

---

## Why Log Thread?

**Stop AI hallucinations. Start shipping accurate code.**

Traditional AI coding assistants guess at your codebase structure, leading to duplicate functions, broken imports, and code that doesn't match your patterns. Log Thread solves this by understanding your entire codebase before making suggestions.

**Benefits:**
- ✅ **No more duplicate code** — AI sees what already exists
- ✅ **Accurate imports** — Knows exactly where functions live
- ✅ **Consistent patterns** — Follows your existing code style
- ✅ **Impact awareness** — Understands what will break before suggesting changes
- ✅ **Works with any AI** — Cursor, Windsurf, Claude, ChatGPT, or any MCP-compatible tool

---

## Quick Start

```bash
# Install
pip install logthread

# Authenticate (required)
logthread login

# Index your codebase
cd your-project
logthread analyze .

# Start using with your AI assistant
logthread serve --watch
```

---

## Features

### 🔍 Smart Code Search
Find exactly what you need, not just keyword matches. Results are organized by how code actually flows together.

### 🎯 Impact Analysis
See what will break before you change it. Log Thread shows which parts of your code depend on each function.

### 🏗️ Architecture Understanding
Automatically identifies which parts of your codebase work together as modules and subsystems.

### 💀 Dead Code Detection
Find unused functions and files that are safe to delete.

### 🔄 Live Updates
Automatically re-indexes when you save files, keeping context fresh.

### 📊 Visual Dashboard
Browse your codebase visually with an interactive web interface.

---

## Supported Languages

Python • TypeScript • JavaScript • Go • Java • C# • Ruby

---

## Setup with Your AI Assistant

### Cursor
Add to your MCP settings (`~/.cursor/mcp.json`):
```json
{
  "logthread": {
    "command": "logthread",
    "args": ["serve", "--watch", "--path", "/absolute/path/to/your/project"]
  }
}
```

### Windsurf
Add to your MCP config (`~/.codeium/windsurf/mcp_config.json`):
```json
{
  "mcpServers": {
    "logthread": {
      "command": "logthread",
      "args": ["serve", "--watch", "--path", "/absolute/path/to/your/project"]
    }
  }
}
```

### Claude Desktop
Add to your Claude config (`~/Library/Application Support/Claude/claude_desktop_config.json`):
```json
{
  "mcpServers": {
    "logthread": {
      "command": "logthread",
      "args": ["serve", "--watch", "--path", "/absolute/path/to/your/project"]
    }
  }
}
```

> **Note:** Replace `/absolute/path/to/your/project` with the full path to your indexed repository. The `--path` option is required so the MCP server knows which codebase to serve.

After setup, restart your AI assistant. Log Thread will automatically provide code intelligence context.

---

## Pricing

**$4.99/month** — Unlimited repositories, unlimited AI queries

Start with a free account at [logthread.dev](https://logthread.dev)

---

## CLI Commands

```bash
logthread login              # Authenticate
logthread analyze .          # Index current directory
logthread serve --watch      # Start MCP server
logthread ui                 # Open dashboard
logthread status             # Show index info
```

---

## Support

Questions or issues? Email us at hello@logthread.dev

---

**Log Thread** — Make your AI assistant smarter.
