# AirContext (per-project)

This directory configures AirContext for **this project**. It was created the
first time you ran `aircontext` here.

## Files

- `config.yaml` — backend (LLM), trigger threshold, compaction options
- `rules.md` — compression rules sent to the LLM as system prompt
- `state.json` — runtime state (do not edit; managed by the plugin)
- `snapshots/` — backup of each JSONL before compaction; keep or delete freely

## Getting started

1. Open `config.yaml`, set `backend.endpoint` / `backend.model` / `backend.api_key`.
   The default targets DeepSeek; replace with Ollama or any OpenAI-compatible
   server as needed. For Ollama set `endpoint: http://localhost:11434/v1` and
   any non-empty `api_key`.
2. Tune `trigger.threshold` (default 0.6 = compact at 60% of model context).
3. Edit `rules.md` to bias summaries toward what your project considers important.
4. Re-run `aircontext` from this directory.

## Disabling auto compaction temporarily

Run `/aircontext-pause` inside Claude Code, or set `safety.dry_run: true` in
config.yaml.