Skip to content
ArtemisKit ArtemisKit

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”
Terminal window
artemiskit history [options]
akit history [options]

Options

Section titled “Options”
OptionDescriptionDefault
-p, --project <project>Filter by project name—
-s, --scenario <scenario>Filter by scenario name—
-l, --limit <number>Limit number of results20
--config <path>Path to config fileartemis.config.yaml

Examples

Section titled “Examples”

View Recent Runs

Section titled “View Recent Runs”
Terminal window
akit history

Filter by Project

Section titled “Filter by Project”
Terminal window
akit history --project my-project

Filter by Scenario

Section titled “Filter by Scenario”
Terminal window
akit history --scenario auth-tests

Combine Filters with Limit

Section titled “Combine Filters with Limit”
Terminal window
akit history --project my-project --scenario qa-suite --limit 10

Output

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)

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 AM
ar-20260117-def  qa-suite  88.5%  1/17/2026, 2:22:00 PM

Empty 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-runs

Or for Supabase:

storage:
  type: supabase
  url: ${SUPABASE_URL}
  anonKey: ${SUPABASE_ANON_KEY}

See Also

Section titled “See Also”