CanYouHack CLI

A fast, professional terminal client for the CanYouHack platform.
Built for binary distribution and daily CTF workflow without opening browser tabs.

Why Use This?

CanYouHack CLI gives you direct command-line access to core canyouhack.org actions:

• login/session management
• arena/challenges workflow
• attachment downloads
• leaderboard/rank tracking
• blogs/writeups/notifications

Everything is designed for speed, clear output, and practical CTF usage.

Example Output

$ canyouhack leaderboard novruzctf-2026

Leaderboard: NovruzCTF 2026
Slug: novruzctf-2026
Time: ends in 0d 03h 24m
Your Rank: #12 | Your Score: 1840

 1) root_shell             score:3200 solves:18 last:2026-04-13 10:11
 2) pwnrangers             score:3040 solves:17 last:2026-04-13 10:20
 3) 0xAzer                 score:2980 solves:16 last:2026-04-13 10:33
...

Features

Interactive REPL — Command autocomplete and terminal-first workflow.

Challenge flow — arena, play, and challenges with in-flow flag submission.

Inline downloads — Use get / download globally or directly inside challenge prompt (get 1).

Ranking visibility — Check event scoreboard and your current rank using leaderboard / rank.

Content access — Read blogs, writeups, and notifications without leaving terminal.

Self-update support — update command for controlled binary refresh workflow.

Command Set

Command	Description
login	Log in to CanYouHack
logout	Log out and clear local session
whoami	Show current logged-in user
profile	Show profile summary
arena	Browse events and enter event flow
play	Open event challenge flow directly
challenges	Global practice challenges
download, get	Download challenge files
leaderboard, rank	Event ranking and your position
blogs	Browse/read community blogs
writeups	Browse/read writeups
notifications	View and mark notifications
update	Update binary from configured source

Installation (Binary-Only)

Clone or download this package, then install using included scripts.

git clone https://github.com/canyouhack-org/canyouhack-cli
cd canyouhack-cli

Linux

chmod +x install.sh
./install.sh

Windows (PowerShell)

Set-ExecutionPolicy -Scope Process Bypass
.\install.ps1

Verify Release Integrity

cd release
sha256sum -c SHA256SUMS.txt --ignore-missing

Usage

# Start interactive shell
canyouhack

# Auth/session
canyouhack login
canyouhack whoami
canyouhack profile

# Event and challenge flow
canyouhack arena
canyouhack play novruzctf-2026
canyouhack challenges

# Downloads
canyouhack get "https://api.canyouhack.org/uploads/file.zip"

# Ranking
canyouhack leaderboard novruzctf-2026
canyouhack rank novruzctf-2026

# Content
canyouhack blogs
canyouhack writeups
canyouhack notifications

# Update
canyouhack update

Uninstall

chmod +x uninstall.sh
./uninstall.sh

Notes

• This release package is intended for binary distribution.
• Source code can be kept private/internal if required.
• Runtime session config is stored locally (~/.canyouhack/config.json).

License

This project is licensed under the MIT License. See the LICENSE file for details.

Contributing

For issues, improvements, or command ideas, open an issue or PR in your source repository.

---

Built by CanYouHack — Learn, compete, and grow in cybersecurity.