Metadata-Version: 2.5
Name: anix-ctx
Version: 0.1.0
Summary: Interactive context packager for LLMs with dark neon TUI (ANIX ecosystem)
Author: ANIX Team
License-Expression: MIT
Keywords: cli,context,developer-tools,llm,markdown,textual,tui
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Build Tools
Classifier: Topic :: Utilities
Requires-Python: >=3.10
Requires-Dist: pathspec>=0.12.0
Requires-Dist: pyperclip>=1.8.0
Requires-Dist: textual>=0.40.0
Description-Content-Type: text/markdown

# ⚡ anix-ctx

> Интерактивный упаковщик контекста проекта для LLM (Gemini, ChatGPT, Claude) в тёмном неоновом стиле экосистемы **ANIX**.

Одной командой открывает быстрый TUI, где можно визуально выбрать нужные файлы проекта, увидеть реальный расход токенов и скопировать всё в буфер обмена в идеальном Markdown-формате с ASCII-деревом файлов.

---

## ✨ Возможности

- **🚀 Мгновенный запуск**: `anix-ctx` в любой папке открывает интерактивный TUI.
- **🛡 Умная фильтрация**: автоматически игнорирует `.git`, `node_modules`, `__pycache__`, `.venv`, лок-файлы (`package-lock.json`, `poetry.lock`, `uv.lock` и др.), бинарные файлы и любые правила из `.gitignore` / `.ignore`.
- **⚡ Кэшированная статистика**: переключение чекбоксов не нагружает диск — токены и символы пересчитываются мгновенно из оперативной памяти.
- **📊 Живая аналитика**: точный подсчёт символов, оценка токенов (`chars // 4`), Top-5 самых тяжёлых файлов и превью ASCII-дерева в реальном времени.
- **🔒 Защита разметки**: адаптивный динамический fence (минимум ` ```` `) гарантирует, что вложенные блоки кода и `.md` файлы не сломают Markdown.
- **🌐 Безопасная кодировка**: чтение файлов с `utf-8` и заменой некорректных символов (`errors="replace"`), полная кроссплатформенность (Windows, Linux, macOS).
- **⚡ Быстрый режим (Headless)**: флаги `--copy` (`-c`) и `-o context.md` для мгновенной сборки контекста без открытия интерфейса.

---

## 📦 Установка

```bash
# Клонирование или установка в режиме разработки
git clone https://github.com/anix/anix-ctx.git
cd anix-ctx
pip install -e .
```

Либо сборка стандартного wheel:

```bash
python -m build
pip install dist/anix_ctx-*.whl
```

---

## 🎮 Использование

### 1. Интерактивный TUI (по умолчанию)

```bash
# Открыть TUI для текущей директории
anix-ctx

# Открыть TUI для конкретной папки
anix-ctx /path/to/project
```

#### Горячие клавиши в TUI:
| Клавиша | Действие |
| :--- | :--- |
| `Space` | Переключить выбор текущего файла или всей папки |
| `Enter` / Клик | Раскрыть/свернуть папку или переключить файл |
| `a` | Выбрать все / Снять выбор со всех файлов |
| `c` | Скопировать готовый Markdown-контекст в буфер обмена |
| `s` | Сохранить контекст в файл `context.md` |
| `q` | Выйти из программы |

---

### 2. Быстрый headless-режим (без TUI)

```bash
# Упаковать текущий проект и сразу скопировать в буфер обмена
anix-ctx --copy
anix-ctx -c

# Упаковать проект в файл context.md
anix-ctx -o context.md

# Упаковать конкретную подпапку сразу в буфер
anix-ctx src/ --copy
```

---

## 📋 Формат вывода Markdown

Контекст упаковывается в чистую и готовую для промпта структуру:

````markdown
# Project Context

## File Tree
````
anix-ctx
├── src/
│   └── anix_ctx/
│       ├── __init__.py
│       ├── cli.py
│       ├── formatter.py
│       ├── scanner.py
│       └── tui.py
├── pyproject.toml
└── README.md
````

## Files

### `pyproject.toml`
````toml
...
````

### `src/anix_ctx/cli.py`
````python
...
````
````

---

## 🛠 Стек

- **Python**: 3.10+
- **TUI Framework**: [Textual](https://github.com/Textualize/textual)
- **Gitignore Engine**: [PathSpec](https://github.com/cpburnz/python-pathspec)
- **Clipboard**: [Pyperclip](https://github.com/asweigart/pyperclip)
- **Лицензия**: MIT (ANIX Ecosystem)
