cortex-query

---
name: "cortex-query"
description: "Search, browse, and export your Knowledge Cortex flat files."
license: "MIT"
---

# Knowledge Cortex — Query

Search, browse, and export your Knowledge Cortex flat files.

## When invoked

Read `{skill_path}/references/file-schema.md` for the storage format.

## Commands

| What user says | Action |
|----------------|--------|
| "cortex stats" | Show knowledge base stats |
| "cortex search QUERY" | Search across all records |
| "cortex client DOMAIN" | Full dossier for a client |
| "cortex contacts [filter]" | List contacts |
| "cortex export TYPE" | Export contacts, clients, knowledge, or comms |
| "cortex prune" | Remove low-value records |

## Usage

```bash
python3 {skill_path}/scripts/cortex-query.py stats
python3 {skill_path}/scripts/cortex-query.py search "QUERY"
python3 {skill_path}/scripts/cortex-query.py client domain.com
python3 {skill_path}/scripts/cortex-query.py contacts [filter]
python3 {skill_path}/scripts/cortex-query.py export contacts --format csv
python3 {skill_path}/scripts/cortex-query.py export knowledge --format json
python3 {skill_path}/scripts/cortex-query.py prune --dry-run
python3 {skill_path}/scripts/cortex-query.py prune
```

Print output directly to the user.

## Environment

| Variable | Default | Purpose |
|----------|---------|---------|
| `CORTEX_DIR` | `~/.cortex` | Storage root |

## References

- File schemas: `{skill_path}/references/file-schema.md`