artemiskit history
artemiskit history
Section titled “artemiskit history”View the history of past evaluation runs stored locally or in configured storage.
Synopsis
Section titled “Synopsis”artemiskit history [options]akit history [options]Options
Section titled “Options”| Option | Description | Default |
|---|---|---|
-p, --project <project> | Filter by project name | — |
-s, --scenario <scenario> | Filter by scenario name | — |
-l, --limit <number> | Limit number of results | 20 |
--show-cost | Show cost column and total | false |
--config <path> | Path to config file | artemis.config.yaml |
Examples
Section titled “Examples”View Recent Runs
Section titled “View Recent Runs”akit historyFilter by Project
Section titled “Filter by Project”akit history --project my-projectFilter by Scenario
Section titled “Filter by Scenario”akit history --scenario auth-testsCombine Filters with Limit
Section titled “Combine Filters with Limit”akit history --project my-project --scenario qa-suite --limit 10Show Cost Information
Section titled “Show Cost Information”Display estimated costs for each run and a total:
akit history --show-costOutput
Section titled “Output”The history command displays runs in a formatted table:
╔════════════════════════════════════════════════════════════════════════════╗║ RUN HISTORY ║╠════════════════════════════════════════════════════════════════════════════╣║ Run ID Scenario Success Rate Date ║╟────────────────────────────────────────────────────────────────────────────╢║ ar-20260118-abc auth-tests 95.0% 1/18/26 10:30 ║║ ar-20260117-def qa-suite 88.5% 1/17/26 14:22 ║║ ar-20260117-ghi stress-test 100.0% 1/17/26 09:15 ║╚════════════════════════════════════════════════════════════════════════════╝
Showing 3 runs (limit: 20)With Cost Column
Section titled “With Cost Column”When using --show-cost, the table includes a cost column and total:
╔═════════════════════════════════════════════════════════════════════════════════════════╗║ RUN HISTORY ║╠═════════════════════════════════════════════════════════════════════════════════════════╣║ Run ID Scenario Success Rate Cost Date ║╟─────────────────────────────────────────────────────────────────────────────────────────╢║ ar-20260118-abc auth-tests 95.0% $0.0234 1/18/2026 10:30 AM ║║ ar-20260117-def qa-suite 88.5% $0.0156 1/17/2026 2:22 PM ║║ ar-20260117-ghi stress-test 100.0% $0.0089 1/17/2026 9:15 AM ║╟─────────────────────────────────────────────────────────────────────────────────────────╢║ Total: $0.0479 ║╚═════════════════════════════════════════════════════════════════════════════════════════╝Runs without cost data (pre-v0.2.3) show ”-” in the cost column.
Success Rate Colors
Section titled “Success Rate Colors”- Green — 90% or higher
- Yellow — 70% to 89%
- Red — Below 70%
CI/CD Output
Section titled “CI/CD Output”In non-TTY environments (CI/CD pipelines, redirected output), a simplified plain-text format is used:
=== RUN HISTORY ===
ar-20260118-abc auth-tests 95.0% 1/18/2026, 10:30:00 AMar-20260117-def qa-suite 88.5% 1/17/2026, 2:22:00 PMEmpty Results
Section titled “Empty Results”If no runs are found, the command provides helpful feedback:
No runs found.
Filters applied: Project: my-project Scenario: auth-tests
Try removing filters or run some tests first.Storage Configuration
Section titled “Storage Configuration”The history command reads from your configured storage backend. Configure storage in artemis.config.yaml:
storage: type: local basePath: ./artemis-runsOr for Supabase:
storage: type: supabase url: ${SUPABASE_URL} anonKey: ${SUPABASE_ANON_KEY}See Also
Section titled “See Also”- Run Command — Run evaluations and save results
- Compare Command — Compare two runs
- Report Command — Generate reports from saved runs
- Storage Backends — Configure storage options