Olympus CLI

The Olympus CLI is the terminal interface for Project Olympus on Shipd (https://shipd.ai/quests/olympus). Use it to inspect a challenge, download it locally, run checks, and manage rollouts.

Install

npm install -g @shipd-ai/olympus-cli

The CLI checks for newer published versions and will suggest:

npm install -g @shipd-ai/olympus-cli@latest

Get Started

1. Sign in:

olympus auth login

2. Open a challenge:

olympus problems view <challenge-id>

3. From there, the CLI will suggest the most useful next commands.

Common Workflows

Inspect a challenge

olympus problems view <challenge-id>
olympus checks view <challenge-id>
olympus runs view <challenge-id>

Use problems view as the main entrypoint. It shows the latest version, readiness, checks, rollouts, and review history.

Download a challenge locally

olympus problems download <challenge-id>
cd olympus-<challenge-id>-v<version>
make clone
make build-image

This writes a local folder with:

• task.md
• Dockerfile when present
• test.patch when present
• solution.patch when present
• hint.md when present
• solution-approach.md when present
• metadata.json
• Makefile

The generated Makefile clones the source repo recursively, checks out the pinned commit, and builds from the checked-out repo context on linux/amd64.

Run checks

olympus checks view <challenge-id>
olympus checks run-all <challenge-id>
olympus checks wait <challenge-id>

Run rollouts

olympus runs presets <challenge-id>
olympus runs run <challenge-id> --preset full
olympus runs run <challenge-id> --solver nova --evaluator orion --count 3
olympus runs wait <challenge-id>

run-all is kept as a compatibility alias for --preset full.

Create or edit a draft

olympus problems create --title "My draft"
olympus problems edit <challenge-id> --description-file task.md
olympus problems version create <challenge-id>

JSON Output

Read commands support --json when you want machine-readable output.

Examples:

olympus problems view <challenge-id> --json
olympus checks view <challenge-id> --json
olympus runs view <challenge-id> --json

Environment

| Env var | Default | Purpose | |---------|---------|---------| | OLYMPUS_URL | https://shipd.ai/quests/olympus | Frontend base URL for auth and config | | OLYMPUS_CONVEX_URL | fetched from /api/cli/config | Convex URL override |

Credentials are stored at ~/.shipd/olympus/credentials.json.

Developer Notes

Run locally against the dev Olympus frontend:

cd quests/olympus/cli
pnpm install
OLYMPUS_URL=http://localhost:3006/quests/olympus pnpm cli auth login

Release checklist:

pnpm --dir quests/olympus/cli typecheck
pnpm --dir quests/olympus/cli build
cd quests/olympus/cli
npm pack --dry-run
npm publish