chofex-cli

Command-line client for Hack the Andes.

Install

npm install --global chofex-cli@latest

The installed command is chofex:

chofex
chofex whoami
chofex update
chofex upgrade
chofex register
chofex status
chofex requirements
chofex challenge list
chofex challenge query
chofex challenge notebook
chofex challenge test --source ./shipping.js
chofex challenge evaluate --source ./shipping.js
chofex challenge ranking
chofex confirm

chofex update and chofex upgrade are interchangeable; both update the CLI to the latest published version.

chofex register collects and submits an application with full name, role, optional phone number, bio, portfolio URL, shipped project, LinkedIn and GitHub URLs, and Terms and Conditions. Use --input to submit a completed JSON application. The Black Box does not block submission, but every challenge winner must submit an application before being accepted. Top results receive a direct pass; other scores give organizers another review metric.

The public ranking is read-only at https://hacktheandes.com/challenges.

Run chofex for a compact retro welcome screen with a pixel Sacred Valley and the main commands. Run chofex --help for the full command reference. The landscape uses colored terminal cells, with readable text that works with your terminal's line spacing. It adapts to the terminal width and has a plain ASCII fallback when color is disabled with NO_COLOR. JSON output and individual command results omit the welcome screen.

For agent or script input, chofex schema --stage application and chofex schema --stage acceptance print complete templates containing every accepted JSON key. Validate a completed input file locally before submitting it:

chofex --output json validate --stage application --input application.json

Validation does not contact the API, and a successful result does not echo input values. Local validation errors include acceptedFields in JSON mode. The status response already includes both the registration and its requirements; use requirements only when requirements-only human output is preferred.

Run chofex login to authenticate. For automation, provide an OAuth access token with CHOFEX_TOKEN.

Authentication troubleshooting

If chofex login succeeds but whoami or an authenticated challenge command returns AUTHENTICATION_REQUIRED, first remove any token or API URL overrides from the shell. In Bash or Zsh:

unset CHOFEX_TOKEN CHOFEX_API_URL

In PowerShell:

Remove-Item Env:CHOFEX_TOKEN, Env:CHOFEX_API_URL -ErrorAction SilentlyContinue

Update by repeating the installation method you originally used. For npm:

npm install --global chofex-cli@latest

For the standalone installer:

curl -fsSL https://hacktheandes.com/install | bash

Then renew the stored session and verify it:

chofex --version
chofex logout
chofex login
chofex --output json whoami

Versions before 0.1.140 used a retired API origin whose cross-origin redirect removed the bearer token. Versions 0.1.140 through 0.1.145 call https://hacktheandes.com but still mint OAuth tokens from the retired Clerk application, so login can print success while whoami and status return AUTHENTICATION_REQUIRED. Current releases (0.1.146 and later) use https://clerk.hacktheandes.com. If the API still responds with Authentication failed after updating, share the CLI version, error code, and request ID when asking for support. For a different local authentication error, share its code and message instead. Never share the access or refresh token.

When applying again after a rejection, interactive registration pre-fills the previous application's answers. Keep a value by pressing Enter, or press Ctrl+U and type a replacement for an answer that needs to change.

Accepted participants must confirm which profile picture reviewers should use: their Clerk picture, their GitHub avatar, or a custom upload. Interactive confirmation prompts for the choice and local file path. For JSON input, set pictureSource and pass --picture /path/to/image when its value is upload. Uploads show percentage progress and accept JPEG, PNG, or WebP files up to 5 MB.

API requests use https://hacktheandes.com by default. Use CHOFEX_API_URL to override the API URL when running against a local or preview Chofex instance.

Registration links use https://hacktheandes.com by default. Local or preview environments can override that origin with CHOFEX_PUBLIC_SITE_URL.