| name | run-query |
| description | Query the run index and vault for experiment history. Search by tag, date, type, or claim. Returns run metadata and pointers without loading raw data. |
| version | 1.0 |
| metadata | {"author":"swarm-research-os","generated_from":"research-os-v0.1"} |
| allowed-tools | Read Glob Grep Bash |
EXECUTE NOW
Query: $ARGUMENTS
Parse the query type:
tag <tag> — find runs by tag
date <YYYY-MM-DD> or date <YYYY-MM> — find runs by date
type <single|sweep|redteam|study|calibration> — find runs by type
claim <claim-id> — find runs linked to a claim
recent [N] — show N most recent runs (default 10)
stats — show run index statistics
- Free text — search run-index.yaml and vault for matches
Execution
Source files
- Run index:
/Users/raelisavitt/swarm-artifacts/run-index.yaml
- Vault claims:
/Users/raelisavitt/swarm-artifacts/vault/claims/
- Vault experiments:
/Users/raelisavitt/swarm-artifacts/vault/experiments/
- Run metadata:
/Users/raelisavitt/swarm-artifacts/runs/<run_id>/run.yaml
For tag queries
Search run-index.yaml for entries where tags contains the search term.
For claim queries
- Read the claim file at
vault/claims/<claim-id>.md
- Extract run references from
evidence.supporting and evidence.weakening
- Look up each run in
run-index.yaml
- Return a summary table
Output format
## Run Query Results: {query}
| Date | Run ID | Type | Tags | Key Finding |
|------|--------|------|------|-------------|
| ... | ... | ... | ... | ... |
{N} runs matched.
For individual run details, also show:
- Hypothesis
- Parameters swept
- Primary result
- Claims affected
- Reproduction command