Metadata-Version: 2.4
Name: jinjinxia-client
Version: 1.0.0
Summary: Zero-intrusion adapter for JinJinXia — uploads chat messages to server for analysis
Requires-Python: >=3.10
Description-Content-Type: text/markdown

# jinjinxia-client

Zero-intrusion adapter for JinJinXia — installs native hooks
into AI coding agents to automatically upload chat messages to the server
for analysis.

**No dependencies.** Pure Python stdlib.

## Install

```bash
pip install jinjinxia-client           # from PyPI (when published)
pip install .                          # from source (this directory)
pipx install .                         # isolated install
```

## Usage

```bash
# Install adapter for Claude Code
jinjinxia-client install claude-code --url http://jinjinxia.company.com:8080

# Install adapter for Copilot CLI
jinjinxia-client install copilot --url http://jinjinxia.company.com:8080

# Check status
jinjinxia-client status

# Uninstall
jinjinxia-client uninstall claude-code
jinjinxia-client uninstall copilot
```

## What It Does

1. `install` writes a native hook config into the agent platform's settings
2. The hook script runs automatically at each session end (< 100ms)
3. It reads the session transcript and uploads new messages to the JinJinXia server
4. The server analyzes sessions after inactivity timeout, clusters issues, and generates PRs
5. The client itself does no analysis — all intelligence is server-side

## How Hooks Are Registered

| Platform | Config file | Hook event |
|----------|-------------|------------|
| Claude Code | `~/.claude/settings.json` → `hooks.Stop` | Stop (agent finishes responding) |
| Copilot CLI | `~/.copilot/hooks/jinjinxia.json` → `agentStop` | agentStop (agent finishes turn) |
