cpu-mode

Command-line client for cpu.mode, a benchmark judge for tiny systems-code challenges.

This repository is intentionally separate from the private server and judge repo. The CLI talks only to the public HTTP API.

Install

From crates.io:

cargo install cpu-mode

From source:

cargo install --git https://github.com/s7nfo/cpu-mode-cli

Upgrade an existing install:

cargo install cpu-mode --force

Login

cpu-mode auth login

The CLI uses the cpu.mode headless login flow. It prints a GitHub verification URL and code, waits for approval, then stores a cpu.mode API token locally.

The server-side auth endpoints are:

POST /auth/cli/start
POST /auth/cli/poll
GET  /auth/session

Examples

List challenges:

cpu-mode challenges list

Print the raw API response:

cpu-mode --raw challenges list

Show challenge metadata:

cpu-mode challenges show counting_bytes

Read a leaderboard:

cpu-mode leaderboard counting_bytes --system raptor_cove_p

Read the all-system geomean slowdown leaderboard:

cpu-mode leaderboard counting_bytes --all-systems

Public solutions that are not ranked because the same user has a faster solution can still appear with a blank rank.

Submit a Rust solution and wait for all system jobs:

cpu-mode submit counting_bytes --lang rust --file solution.rs --wait

Submit C++ with GCC instead of the default Clang compiler:

cpu-mode submit counting_bytes --lang cpp --compiler gcc_cpp --file solution.cpp --wait

Inspect a job:

cpu-mode jobs show job_...

Show queued jobs first, then newest jobs by queue time:

cpu-mode jobs queue

Download a job profile:

cpu-mode jobs profile job_... --output profile.txt

Show a job's top-down analysis:

cpu-mode jobs top-down job_...

Show a solution and make it public:

cpu-mode solutions show sol_...
cpu-mode solutions publish sol_...

Make it private again:

cpu-mode solutions unpublish sol_...

Show a user submission history:

cpu-mode users jobs github:34958324 --challenge counting_bytes --limit 20

Command output is human-readable by default. Pass global --raw when an agent or script needs the exact JSON API response.