What problem does it solve? Scripting against the Archimedes hosted API requires knowing the exact session-file mechanics, the stable exit-code contract, and why verify reports two of the four rigor-gate checks as not_evaluable for a bare returns series — this Skill grounds every one of those claims in file:line citations so an agent never misrepresents what the CLI does. ## Core Features & Use Cases - Three working commands: archimedes login (Better Auth email+password, session cached mode 600), archimedes meter (reads the same quota buckets and price quote the paywall enforces), and archimedes verify RETURNS_CSV (DSR and walk-forward OOS over a two-column CSV). - CI-safe contracts: every command honors --json on every path including errors, and exit codes are stable — 0 pass, 1 gate failed, 2 usage/auth, 3 not implemented — so a CI job can branch on 1 specifically. - Honesty rules: PBO and look-ahead are always not_evaluable for a bare series, a zero-evaluable-leg result never reads as a pass, and backtest / verify --local exit NOT_IMPLEMENTED rather than pretending to work. - Use Case: Wire archimedes verify returns.csv into a CI pipeline, branch on exit code 1 to block deployment of a failing strategy, and give each agent lane its own --session-file to avoid shared-identity overwrites. ## Quick Start Install the CLI from the repo with pip install -e ./cli, then run archimedes login followed by archimedes verify on a two-column date,daily_return CSV to get a DSR and out-of-sample verdict.
