aircontext/templates

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.