Metadata-Version: 2.4
Name: vinemap
Version: 0.1.2
Summary: Vinemap — a local-first, graph-based context engine for AI coding agents
Project-URL: Homepage, https://vinemap.xyz
Project-URL: Repository, https://github.com/rohit0x62/vinemap
Project-URL: Issues, https://github.com/rohit0x62/vinemap/issues
Author: WINK
License: Apache-2.0
Keywords: ai,code-graph,coding-agent,context,llm,mcp
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development
Requires-Python: >=3.9
Provides-Extra: dev
Requires-Dist: cryptography>=42.0; extra == 'dev'
Requires-Dist: fastapi>=0.115; extra == 'dev'
Requires-Dist: httpx>=0.27; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Requires-Dist: tree-sitter-language-pack>=0.7; extra == 'dev'
Requires-Dist: tree-sitter>=0.23; extra == 'dev'
Provides-Extra: embeddings
Requires-Dist: sentence-transformers>=3.0; extra == 'embeddings'
Provides-Extra: license
Requires-Dist: cryptography>=42.0; extra == 'license'
Provides-Extra: treesitter
Requires-Dist: tree-sitter-language-pack>=0.7; extra == 'treesitter'
Requires-Dist: tree-sitter>=0.23; extra == 'treesitter'
Provides-Extra: watch
Requires-Dist: watchdog>=4.0; extra == 'watch'
Description-Content-Type: text/markdown

# Vinemap — Local Code Graph & MCP Context for AI Coding Agents

[![PyPI](https://img.shields.io/pypi/v/vinemap)](https://pypi.org/project/vinemap/)
[![Python](https://img.shields.io/pypi/pyversions/vinemap)](https://pypi.org/project/vinemap/)
[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://github.com/rohit0x62/vinemap/blob/main/LICENSE)

**Vinemap** builds a **local code graph** of your repository and delivers **token-budgeted context packs** to AI coding agents — Claude Code, Cursor, Codex CLI, Gemini CLI, Copilot, and any MCP client.

Stop wasting tokens on blind exploration. Vinemap ranks the right files *before* your agent's first tool call.

## Install

```bash
pip install vinemap
```

Python 3.9+. **Zero runtime dependencies.**

## Quick start

```bash
vinemap index .                              # build code graph → .vinemap/
vinemap query "where is auth handled"        # ranked search
vinemap pack  "how do sessions work" --budget 6000
vinemap mcp .                                # MCP server (stdio)
vinemap connect cursor                       # auto-configure Cursor
```

## MCP integration

```json
{
  "mcpServers": {
    "vinemap": {
      "command": "vinemap",
      "args": ["mcp", "/path/to/project"]
    }
  }
}
```

**Tools:** `graph_retrieve` · `graph_read` · `graph_neighbors` · `graph_stats`

## Why Vinemap?

- **Graph-native context** — files, symbols, imports, call edges (not just text chunks)
- **Token-budgeted packs** — `<codebase_context>` blocks sized to your budget
- **Session memory** — remembers touched files and decisions across turns
- **100% local** — nothing leaves your machine
- **MCP-native** — works with Cursor, Claude Code, Codex, Gemini, and more

## Supported languages

Python (AST), TypeScript, JavaScript, Go, Rust, Java, C/C++, C#, Ruby, PHP, Kotlin, Swift.

## Links

- **GitHub:** [github.com/rohit0x62/vinemap](https://github.com/rohit0x62/vinemap)
- **Docs & roadmap:** [github.com/rohit0x62/vinemap/tree/main/docs](https://github.com/rohit0x62/vinemap/tree/main/docs)
- **Website:** [vinemap.xyz](https://vinemap.xyz)

## License

Apache-2.0
