Metadata-Version: 2.4
Name: usecix
Version: 1.0.6
Summary: Git-anchored cloud-first code index + MCP for Claude, Codex, and Gemini
License-Expression: LicenseRef-cix-Proprietary
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: mcp>=1.0.0
Requires-Dist: pyjwt[crypto]>=2.8
Requires-Dist: tqdm>=4.65
Requires-Dist: watchfiles>=0.24
Provides-Extra: remote
Requires-Dist: uvicorn>=0.31; extra == "remote"
Requires-Dist: starlette>=0.41; extra == "remote"
Provides-Extra: db-pull
Requires-Dist: psycopg[binary]>=3.1; extra == "db-pull"
Requires-Dist: pymysql>=1.1; extra == "db-pull"
Requires-Dist: pymongo>=4.6; extra == "db-pull"
Requires-Dist: PyYAML>=6.0; extra == "db-pull"
Provides-Extra: test
Requires-Dist: testcontainers>=4.0; extra == "test"
Requires-Dist: psycopg[binary]>=3.1; extra == "test"
Requires-Dist: pymysql>=1.1; extra == "test"
Requires-Dist: pymongo>=4.6; extra == "test"
Requires-Dist: PyYAML>=6.0; extra == "test"
Provides-Extra: build
Requires-Dist: build>=1.0; extra == "build"
Requires-Dist: nuitka>=2.0; extra == "build"
Dynamic: license-file

# cix

**Git moves code. cix understands code. AI coding tools use cix to make safer changes.**

cix is a code-intelligence layer that sits between Git and AI coding tools
(Claude Code, Codex, Gemini). It indexes your committed source by Git commit
and exposes it to your AI client as a set of structured tools — symbol search,
navigation, schema lookup, impact analysis, and structured edits — so the
assistant works from what your repository *actually* contains instead of
guessing.

## Why

AI coding tools are strong at writing code in isolation and weak at
understanding *your* repository. They re-read files they have already seen,
reinvent helpers that already exist, import modules that were deprecated, or
rename a function and miss half of its callers. cix gives the assistant a
precise, current answer to "what does this repository mean right now?" — so it
writes code that fits.

## Install

```bash
pip install usecix
```

The heavy indexing runs in the cix cloud, not on your machine; the local
package is a thin client that connects over HTTPS.

## Quick start

```bash
# 1. Connect this machine to your cix account (opens a browser)
cix login

# 2. Register cix with your AI clients (Claude Code, Codex, Gemini)
cix install --client all

# 3. Restart your client so it picks up the cix tools

# 4. In a project you want indexed
cd ~/path/to/your/project
cix index
```

Then open your AI client in that project and start working — it will use the
cix tools to search, read by symbol, check schemas, and assess impact before
editing.

## Commands

cix installs a single `cix` dispatcher; each subcommand is also available as
`cix-<command>` (for example, `cix-index`).

| Command | What it does |
| --- | --- |
| `cix login` | Authenticate and fetch credentials |
| `cix install` | Install cix integrations (Claude, Codex, Gemini) |
| `cix uninstall` | Remove cix integrations |
| `cix index` | Build / update the index for the current project |
| `cix mcp` | Run the cix MCP server (stdio) |
| `cix serve` | Run the cix MCP server (remote SSE) |
| `cix doctor` | Diagnose your cix install and project setup |
| `cix config` | View / update per-project settings |

Run `cix <command> --help` for details on any command.

## Requirements

- **Python 3.11+**
- **Git** — cix indexes committed source and tracks freshness by commit.
- **A GitHub-hosted repository** for the project you want indexed.
- **A supported AI client** — Claude Code, Codex CLI, and/or Gemini CLI.
- **A cix account** — `cix login` walks you through it.

## License

cix is proprietary software. See the bundled `LICENSE` file. It is not open
source, and is not MIT- or dual-licensed.
