v0.1.0
First release
Rate-limited CTFd parser with CLI + Discord bot for small-team CTF collaboration. Every action auto-syncs to a shared private git repo.
Features
- Rate-limited API client — 1 req/sec with exponential backoff on 429s
- Cache-first — fetches once, polls for changes every 10 minutes
- Full challenge details — descriptions, files, hints fetched and stored
- File downloads — challenge attachments downloaded during init
- Git-native collaboration — claims, solves, notes auto-commit to shared repo
- Discord bot — slash commands for team coordination (
/ctf start,/claim,/solve,/note,/writeup) - CLI — terminal workflow with
ctfd init,ctfd claim,ctfd solve, etc. - Multi-CTF — manage multiple competitions simultaneously
- Private channels — Discord CTF channels are private by default
- Direct CTFd links — challenge threads and markdown include links to the live challenge
Authentication
- API token auth (
--tokenorCTFD_TOKEN) - Username/password auth (
--username/--passwordorCTFD_USERNAME/CTFD_PASSWORD) - CSRF nonce handling for CTFd instances requiring session auth
- Lazy CSRF token fetch for flag submission
Security
- Path traversal protection
- SSRF blocking for private IPs
- Credential isolation from git repos
- bot.json with 0600 permissions